Skills & MCP Server

SocialCrawl is available as two standalone packages that give AI agents direct access to the API. Both cover the same 21 platforms and 108 endpoints — choose whichever matches your AI client.

Skills Package

The @socialcrawl skill works with Claude Code, Cursor, Windsurf, Codex, Gemini CLI, and 40+ other agents. It lets your agent fetch live social media data, generate code snippets, and answer API questions through natural language.

Install

# Via skills.sh (recommended)
npx skills add socialcrawl/skills

# Global (available in all projects)
npx skills add socialcrawl/skills -g

# Via Git (manual)
git clone https://github.com/socialcrawl/skills .claude/skills/socialcrawl

Set your API key

export SOCIALCRAWL_API_KEY="sc_your_api_key_here"

Add this to your shell profile (~/.bashrc, ~/.zshrc, etc.) so it persists across sessions. If unset, the skill will prompt you inline.

Use it

Invoke the skill directly or just ask in natural language:

/socialcrawl

Get the TikTok profile for @charlidamelio

Search YouTube for "machine learning" videos

The skill identifies the platform and endpoint, makes the API call, and returns structured JSON.

MCP Server

The socialcrawl-mcp server connects any MCP-compatible AI client to the SocialCrawl API. It is published on npm and the MCP Registry.

Install for Claude Code

claude mcp add --scope user socialcrawl -- npx -y socialcrawl-mcp
claude mcp add-env socialcrawl SOCIALCRAWL_API_KEY sc_your_key_here

Install for Claude Desktop, Cursor, VS Code, or Windsurf

Add to your client's MCP config file:

{
  "mcpServers": {
    "socialcrawl": {
      "command": "npx",
      "args": ["-y", "socialcrawl-mcp"],
      "env": {
        "SOCIALCRAWL_API_KEY": "sc_your_key_here"
      }
    }
  }
}

Restart your AI client after saving.

Available tools

The MCP server exposes 4 tools:

Tool	Description	Needs API key?
`socialcrawl_list_platforms`	Discover all 21 platforms with their endpoints and capabilities	No
`socialcrawl_list_endpoints`	See all endpoints, required parameters, and credit costs for a platform	No
`socialcrawl_request`	Make any SocialCrawl API call	Yes
`socialcrawl_get_docs`	Access detailed API documentation by topic or platform	No

Three of four tools work without an API key — they query local bundled data. Only socialcrawl_request requires a key.

Smart validation

Before making any API call, socialcrawl_request validates locally that the platform exists, the endpoint exists, and all required parameters are present. If something is wrong, it tells the agent how to fix it — without consuming any credits.

Skills vs MCP

	Skills	MCP
Install via	skills.sh, Git	npm, MCP Registry
Protocol	Skill files read by agent	MCP stdio transport
Client support	Claude Code, Cursor, Windsurf, Codex, Gemini CLI, 40+	Any MCP-compatible client
Discovery tools	No (skill handles routing)	Yes (3 local-only tools)
Local validation	No	Yes (saves credits)
Offline docs	Yes (reference files)	Yes (bundled data)

Both packages use the same API, response format, and credit system. Pick whichever your AI client supports.

Skills & MCP Server

On this page