Social media data for AI agents

Connect Claude Code, Cursor, Codex, Hermes, Gemini CLI, VS Code or any MCP client to public data from TikTok, Instagram, YouTube, X, Facebook and 28 more platforms. One remote MCP server, nothing to run locally. Every tool returns the same JSON fields on every platform.

Set your key once with export SCRAPEIO_API_KEY=sk_... (get one at scrapeio.com/login), then pick your agent. Plugin manifests and the skill live in github.com/xhoantran/scrapeio-agent.

Skills library

Eight skills that turn the tools into finished research. One command installs them for Claude Code, Codex, Cursor, Gemini CLI, OpenCode, GitHub Copilot and more:

npx skills add xhoantran/scrapeio-agent
SkillWhat it does
scrapeioCore: picks the right endpoint, pages, and reports numbers with links.
influencer-discoveryFinds creators in a niche, filters by followers and real engagement, exports a shortlist.
creator-vettingSpots fake followers, bought engagement and brand-safety issues before a deal.
competitor-social-auditBenchmarks brands across TikTok, Instagram, YouTube, X and LinkedIn.
video-transcript-researchTranscripts from YouTube, TikTok, reels, X and LinkedIn: summaries, quotes, mentions.
comment-insightsTurns comments into questions, objections, sentiment and buying signals.
social-trend-researchTrending videos, hashtags and sounds by country, sized and dated.
ad-library-researchCompetitors' ads in the Meta, Google and LinkedIn ad libraries.

Connect the MCP server

Claude Code

Run once in a terminal. Or install the plugin, which adds the skill too: /plugin marketplace add xhoantran/scrapeio-agent, then /plugin install scrapeio@scrapeio.

claude mcp add --transport http scrapeio https://scrapeio.com/mcp \
  --header "x-api-key: $SCRAPEIO_API_KEY"

Cursor

Add to ~/.cursor/mcp.json (or .cursor/mcp.json in a project).

{
  "mcpServers": {
    "scrapeio": {
      "url": "https://scrapeio.com/mcp",
      "headers": { "x-api-key": "${env:SCRAPEIO_API_KEY}" }
    }
  }
}

Codex

Add to ~/.codex/config.toml. Codex sends the key as a Bearer token, which the server accepts.

[mcp_servers.scrapeio]
url = "https://scrapeio.com/mcp"
bearer_token_env_var = "SCRAPEIO_API_KEY"

Hermes Agent

Hermes asks for the key on install and stores it as SCRAPEIO_API_KEY.

hermes plugins install xhoantran/scrapeio-agent
hermes plugins enable scrapeio

Gemini CLI

Add to ~/.gemini/settings.json.

{
  "mcpServers": {
    "scrapeio": {
      "httpUrl": "https://scrapeio.com/mcp",
      "headers": { "x-api-key": "$SCRAPEIO_API_KEY" }
    }
  }
}

VS Code (Copilot agent mode)

Add to .vscode/mcp.json. VS Code prompts for the key once and keeps it out of the file.

{
  "inputs": [{ "type": "promptString", "id": "scrapeio-key", "description": "ScrapeIO API key", "password": true }],
  "servers": {
    "scrapeio": {
      "type": "http",
      "url": "https://scrapeio.com/mcp",
      "headers": { "x-api-key": "${input:scrapeio-key}" }
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json.

{
  "mcpServers": {
    "scrapeio": {
      "serverUrl": "https://scrapeio.com/mcp",
      "headers": { "x-api-key": "${env:SCRAPEIO_API_KEY}" }
    }
  }
}

Any other MCP client

Any client that speaks Streamable HTTP. The server is also in the official MCP registry as com.scrapeio/scrapeio.

URL:    https://scrapeio.com/mcp
Header: x-api-key: <your key>
   or:  Authorization: Bearer <your key>

What the agent gets

  • Core tools such as tiktok_profile, instagram_comments, youtube_transcript and twitter_search, each with its credit price in the description.
  • list_endpoints and call_endpoint for the long tail (Reddit, LinkedIn, Threads, Pinterest, ad libraries, TikTok Shop and more), so the tool list stays short.
  • Plain files for agents without MCP: /llms.txt, /llms-full.txt, /skill.md and /agents.md.

New to this? Read Give Claude Code, Cursor and Codex live TikTok, Instagram and YouTube data.

100 free credits, no card. Credits never expire.

Get API key