protogrid

Search / com.semscraper/semscraper

Semscraper

R1· needs a key

Real Google and Google Maps SERPs for AI assistants: pixel positions, AI Overviews and sources.

v1.0.0 · active · website · descriptor JSON · versions

An agent can connect on its own if it already holds SEMSCRAPER_TOKEN.Remote endpoint behind a static API key or header. The registry never sees the value; the agent fills the placeholder.
Quality85good
Trust83of 100
Uptime, 30 days100%
Latency p50372 ms

Connect

8 clients · secrets stay placeholders
{
  "mcpServers": {
    "semscraper": {
      "type": "http",
      "url": "https://mcp.semscraper.com/mcp",
      "headers": {
        "Authorization": "Bearer ${SEMSCRAPER_TOKEN}"
      }
    }
  }
}
claude mcp add --transport http semscraper https://mcp.semscraper.com/mcp --header "Authorization: Bearer ${SEMSCRAPER_TOKEN}"
[mcp_servers.semscraper]
url = "https://mcp.semscraper.com/mcp"
bearer_token_env_var = "SEMSCRAPER_TOKEN"
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "semscraper": {
      "type": "remote",
      "url": "https://mcp.semscraper.com/mcp",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer {env:SEMSCRAPER_TOKEN}"
      }
    }
  }
}
{
  "mcpServers": {
    "semscraper": {
      "type": "http",
      "url": "https://mcp.semscraper.com/mcp",
      "headers": {
        "Authorization": "Bearer ${SEMSCRAPER_TOKEN}"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=semscraper&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vbWNwLnNlbXNjcmFwZXIuY29tL21jcCIsImhlYWRlcnMiOnsiQXV0aG9yaXphdGlvbiI6IkJlYXJlciAke1NFTVNDUkFQRVJfVE9LRU59In19"
}
{
  "servers": {
    "semscraper": {
      "type": "http",
      "url": "https://mcp.semscraper.com/mcp",
      "headers": {
        "Authorization": "Bearer ${SEMSCRAPER_TOKEN}"
      }
    }
  }
}
{
  "mcpServers": {
    "semscraper": {
      "httpUrl": "https://mcp.semscraper.com/mcp",
      "headers": {
        "Authorization": "Bearer ${SEMSCRAPER_TOKEN}"
      }
    }
  }
}
extensions:
  "semscraper":
    enabled: true
    name: "semscraper"
    type: streamable_http
    uri: "https://mcp.semscraper.com/mcp"
    headers:
      "Authorization": "Bearer ${SEMSCRAPER_TOKEN}"
    timeout: 300

Placeholders to fill from your own secret store: ${SEMSCRAPER_TOKEN}. The registry never accepts secret values.

Quality 85 / 100good

protocol75 · weight 25
  • warn
    protocol.modernnewest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
  • n/a
    protocol.statelessonly applies to 2026-07-28 servers
  • pass
    protocol.transportstreamable HTTP
  • n/a
    protocol.list_ttlonly applies to 2026-07-28 servers
authorizationn/a · weight 15
  • n/a
    auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
  • n/a
    auth.secret_in_urlno templated URL
tool hygiene93 · weight 30
  • pass
    tools.descriptionsevery tool has a description
  • pass
    tools.description_lengthdescriptions are concise
  • pass
    tools.schemasevery tool has an object input schema
  • pass
    tools.annotations8 of 8 tools declare readOnlyHint or destructiveHint
  • warn
    tools.directory_hints2 of 8 tools declare all four hints; missing: ai_overview_sources (destructiveHint, idempotentHint); list_searches (destructiveHint, idempotentHint); get_balance (destructiveHint, idempotentHint); …
  • pass
    tools.token_costabout 2,889 tokens to load every tool
  • pass
    tools.api_dumptools are not a one-to-one API dump
stabilityn/a · weight 15
  • n/a
    stability.changes, stability.rug_pulltool history recorded for 5 of the 7 days needed
dependenciesn/a · weight 15
  • n/a
    deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

8 tools, about 2,889 tokens to load them all · tool set 372807c70b93 · checked 2026-10-20 10:03 UTC

Tool changes

No tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 83 / 100

no-repository
provenance55
liveness100
freshness100
hygiene80

+dns-namespace +website +reachable +uptime-100% +updated-10d-ago -no-repository

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Endpoints

remoteauthreachableuptime 30dp50protocollast ok
https://mcp.semscraper.com/mcp streamable-httpapi_key ${SEMSCRAPER_TOKEN}yes100%372 ms2025-11-252026-10-20

Tools (8)

ai_overview_sourcesread-onlyComputes, on the server, which domains Google cites in the AI Overviews of searches already created (google_search IDs): for each domain, the number of keywords where it is cited, the number of mentions, the keywords and its best position on the page. Also returns how many searches have an AI Overview. Free. Best tool to answer "which sites does Google cite in its AI Overviews on these keywords": one small answer instead of every SERP. Based on source URLs, not on brand names.
get_balanceread-onlyReturns the balance of the Semscraper account, in euros. Free.
get_queue_statusread-onlyReturns how many searches of the account are pending, processing or done. Free. The account has its own queue: the robots serve accounts in turn, so a large batch flows through gradually.
get_serp_resultsread-onlyReturns searches already created (google_search or google_maps), by their IDs (serp_...), e.g. the pending_ids of a previous call. Free: the searches were paid when created.
google_mapsCollects the listings of a Google Maps search for one or more keywords, in the order Google Maps shows them, from a given place. Each listing comes with its rank, name (title), CID, category (type), address, website, rating, review count, opening status and the snippet shown. Use it for local SEO, local competition and market research. Paid from the account balance, same price as google_search. Returns rating and review count, not the full text of reviews.
google_searchCollects the real Google results page (SERP) for one or more keywords, rendered in a real browser, and returns every block (organic results, ads, local pack, People Also Ask, AI Overview with its citations and sources...) with, for each item, its rank in its block (rank_type), its rank on the page (rank_serp), its Google page and its pixel position. Use it to know what Google actually shows for a query, in a given country, language, city and device. Paid from the account balance: about EUR 0.0003 per keyword for the first page, EUR 0.0002 per extra page. Takes about 30 seconds per keyword (about a minute for 10 pages); the tool waits for the results. Returns titles, snippets and URLs, not the full content of the pages.
list_google_versionsread-onlyLists the supported Google versions as location / language pairs (186 Google domains, 117 languages), to pick valid location and language values. Free. Filter with a country domain, a code or a language name to keep the answer short.
list_searchesread-onlyLists the searches of the account, most recent first (ID, engine, keyword, device, location, language, depth, geolocation, status, whether the results were already fetched, cost, creation date), without their results. Free. Covers every search made with the account, through this server or the API. Use it to find IDs (e.g. "the last 10 searches", "today's searches"), and whenever a google_search or google_maps call failed, timed out or lost its answer: the searches were probably created and paid already, so fetch them with get_serp_results instead of searching again.

Schemas: list_tools.

Similar MCP servers

Official server.json
{
  "name": "com.semscraper/semscraper",
  "title": "Semscraper",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://mcp.semscraper.com/mcp",
      "type": "streamable-http",
      "headers": [
        {
          "name": "Authorization",
          "isSecret": true,
          "isRequired": true,
          "description": "Bearer followed by your Semscraper API key (API keys menu of app.semscraper.com)"
        }
      ]
    }
  ],
  "version": "1.0.0",
  "websiteUrl": "https://www.semscraper.com/en/mcp",
  "description": "Real Google and Google Maps SERPs for AI assistants: pixel positions, AI Overviews and sources."
}