Monthly Search Traffic Overview for a Site Section (US or UK Database)

omnial/subfolder-rank-history

Given a website subfolder (a domain plus a path), returns monthly search overview rows from the US or UK search database: for each month, the number of keywords the subfolder ranks for in organic search, its estimated organic traffic and that traffic's estimated cost, the number of keywords it buys in paid search, its estimated paid traffic and paid traffic cost, and the month the row covers. In testing a one-row call returned the most recent month.

activeper resultv1

Price

Up to $0.00273 per result; you pay what the call used

The price shown is the price you pay. No monthly minimum. Top-ups start at $5.

Data source

Semrush

Data from Semrush.

Use it

Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.

agent

// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "omnial/subfolder-rank-history" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/subfolder-rank-history" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/subfolder-rank-history", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/subfolder-rank-history", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.

Pricing

Every charge this tool can incur.

Charge	Price
Per result Charged for every result returned	$0.00273

Updated: Oct 14, 2026

Input and output schemas

Input schema

input_schema.json

{
  "type": "object",
  "required": [
    "subfolder"
  ],
  "properties": {
    "database": {
      "enum": [
        "us",
        "uk"
      ],
      "type": "string",
      "default": "us",
      "description": "Regional search database: US (the default) or UK."
    },
    "subfolder": {
      "type": "string",
      "minLength": 1,
      "description": "The site section to look up: a domain followed by a path ending in a slash, without a scheme."
    },
    "display_limit": {
      "enum": [
        1,
        100
      ],
      "type": "integer",
      "default": 100,
      "description": "Maximum number of monthly rows to return: 1, or 100 (the report's default)."
    }
  },
  "additionalProperties": false
}

Output schema

output_schema.json

{
  "type": "object",
  "properties": {
    "rows": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "date": {
            "type": "string",
            "description": "The month the row covers, written as YYYYMM15."
          },
          "adwordsCost": {
            "type": "string",
            "description": "Estimated cost of the subfolder's paid search traffic, as a numeric string."
          },
          "organicCost": {
            "type": "string",
            "description": "Estimated cost of the subfolder's organic traffic, as a numeric string."
          },
          "adwordsTraffic": {
            "type": "string",
            "description": "Estimated monthly paid search traffic to the subfolder, as a string."
          },
          "organicTraffic": {
            "type": "string",
            "description": "Estimated monthly organic search traffic to the subfolder, as a string."
          },
          "adwordsKeywords": {
            "type": "string",
            "description": "Number of keywords the subfolder buys in paid search, as a string."
          },
          "organicKeywords": {
            "type": "string",
            "description": "Number of keywords the subfolder ranks for in organic search, as a string."
          }
        }
      },
      "description": "One row per month, up to the requested number of rows."
    },
    "database": {
      "type": "string",
      "description": "The regional search database the rows come from (us or uk)."
    }
  },
  "description": "The subfolder's monthly search overview rows, as returned after shaping."
}