@scrapio/mcp

@scrapio/mcp

Official MCP server for Scrapio — gives AI agents direct access to fetch, crawl, search, and extract structured data from the web.

Works with Claude Desktop, Cursor, Windsurf, and any MCP-compatible agent runtime.

Install

No installation required. Run with npx:

SCRAPIO_API_KEY=sk-... npx @scrapio/mcp

Configure your agent

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "scrapio": {
      "command": "npx",
      "args": ["-y", "@scrapio/mcp"],
      "env": {
        "SCRAPIO_API_KEY": "sk-..."
      }
    }
  }
}

Restart Claude Desktop. The tools appear automatically.

Cursor

Open Cursor Settings → MCP and add a new server, or edit ~/.cursor/mcp.json:

{
  "mcpServers": {
    "scrapio": {
      "command": "npx",
      "args": ["-y", "@scrapio/mcp"],
      "env": {
        "SCRAPIO_API_KEY": "sk-..."
      }
    }
  }
}

Windsurf

Edit ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "scrapio": {
      "command": "npx",
      "args": ["-y", "@scrapio/mcp"],
      "env": {
        "SCRAPIO_API_KEY": "sk-..."
      }
    }
  }
}

HTTP transport (remote / self-hosted)

SCRAPIO_API_KEY=sk-... npx @scrapio/mcp --transport http --port 3010

The server listens on http://localhost:3010/mcp.

Available tools

Tool	Description
fetch	Fetch a URL and return content as markdown, HTML, JSON, or screenshot
google_search	Search Google and return structured organic, news, image, or shopping results
youtube_transcript	Get the full transcript for a YouTube video by URL or video ID
amazon_product	Get structured product data from Amazon by URL, ASIN, or search query
walmart_search	Search Walmart and return structured product listings
interact	Drive a real browser — click, type, scroll, wait for elements
crawl	Crawl one or more seed URLs and return content for every page visited
submit_job	Submit a long-running job asynchronously and return a job ID
get_job	Check job status and retrieve the result when complete

Example prompts

"Fetch the content of https://news.ycombinator.com and summarize the top 5 stories."

"Search Google for 'best TypeScript ORM 2025' and give me the top 3 results."

"Get the transcript of this YouTube video: https://www.youtube.com/watch?v=dQw4w9WgXcQ"

"Find the current price of the Sony WH-1000XM5 headphones on Amazon."

"Crawl https://docs.example.com up to 20 pages and extract all the API endpoint descriptions."

Environment variables

Variable	Required	Description
SCRAPIO_API_KEY	Yes	Your API key. Get one at scrapio.dev
SCRAPIO_BASE_URL	No	Override the API base URL (for local dev or staging)
MCP_PORT	No	Port for HTTP transport. Defaults to 3010

Links

• Documentation
• Get an API key
• Dashboard

License

MIT