MCP server Preview

Use Scrapall from your AI assistant.

A stdio MCP server that calls the public Scrapall API with your key. It ships 15 curated tools plus 2 generic tools that reach every endpoint. Paths below are placeholders until the package is published.

Tools (17)

Curated tools, plus a door to everything

list_endpoints(platform?) lists every path with its methods and params; a required param is marked with *.

call_endpoint(path, params, method="GET") calls any listed path. Unknown paths are rejected locally and never sent.

Curated: tiktok_profile, tiktok_search_videos, tiktok_search_hashtag, instagram_profile, instagram_post, instagram_search_hashtag, youtube_channel, youtube_channel_videos, youtube_channel_search, youtube_search, youtube_video, youtube_video_comments, facebook_post, facebook_ads_search, reddit_search.

Errors return {"error": {"code", "message"}} with codes invalid_key, insufficient_credits, plan_expired, not_found, bad_request, upstream_unavailable.

install (local)bash
python -m venv .venv && .venv/bin/pip install -e .
# command: .venv/bin/brand-social-data-mcp
VariableMeaning
BRAND_API_KEYYour API key (required). Never commit it.
BRAND_API_BASEAPI base URL, e.g. https://api.scrapall.bipsport.com/scapi/scapi
BRAND_OPENAPIOptional path to the endpoint catalogue

  1. Claude Desktop

    Add the server to claude_desktop_config.json, then restart Claude Desktop.

    claude_desktop_config.jsonjson
    {
  "mcpServers": {
    "brand-social-data": {
      "command": "/path/to/mcp/.venv/bin/brand-social-data-mcp",
      "env": {
        "BRAND_API_KEY": "YOUR_KEY",
        "BRAND_API_BASE": "https://api.scrapall.bipsport.com/scapi/scapi"
      }
    }
  }
}

  2. Claude Code

    One command registers the server.

    terminalbash
    claude mcp add brand-social-data \
  -e BRAND_API_KEY=YOUR_KEY -e BRAND_API_BASE=https://api.scrapall.bipsport.com/scapi/scapi \
  -- /path/to/mcp/.venv/bin/brand-social-data-mcp

  3. Codex

    Append a server block to ~/.codex/config.toml.

    ~/.codex/config.tomltoml
    [mcp_servers.brand-social-data]
command = "/path/to/mcp/.venv/bin/brand-social-data-mcp"
args = []
env = { BRAND_API_KEY = "YOUR_KEY", BRAND_API_BASE = "https://api.scrapall.bipsport.com/scapi/scapi" }

Source: mcp/README.md. Keep your key in the env block; never paste it into chat.