Agent docs
One social-data connection for every agent
Connect Codex, Claude Code, Claude Desktop, Cursor, or your own agent to live TikTok, Instagram, YouTube, LinkedIn, X, and Reddit data. Choose the CLI, hosted MCP server, or REST API without changing accounts or data sources.
curl -fsSL https://creatorcrawl.com/install.sh | shHow it fits together
One data layer, three ways to use it
The interfaces are interchangeable. Pick the one that matches who controls the workflow: your agent, your MCP client, or your application code.
CLI + agent skill
Codex, Claude Code, terminal agents, and repeatable research workflows
The skill teaches your agent when and how to use CreatorCrawl. The CLI performs the calls and returns structured JSON.
MCP server
Codex, Claude, Cursor, and OAuth-capable MCP clients
Add one URL, sign in through your browser, and let the model discover and chain CreatorCrawl tools. No API key to copy.
REST API
Custom agents, OpenAI applications, LangChain, scheduled jobs, and product code
Call the same social-data endpoints directly over HTTP when you want full control over orchestration and storage.
CLI + skill
The direct route for Codex and Claude Code
The installer adds a self-contained command-line client and the CreatorCrawl agent skill. The skill supplies workflow knowledge. The CLI authenticates, performs calls, and returns compact JSON your agent can inspect or pipe into another step.
- 1. Run the installer in your agent's shell.
- 2. Complete browser login with
creatorcrawl auth login. - 3. Ask your agent for current social research in natural language.
creatorcrawl auth login
creatorcrawl auth status --jsoncreatorcrawl tiktok profile khaby.lame
creatorcrawl youtube transcript 'https://youtu.be/...'
creatorcrawl linkedin company 'https://linkedin.com/company/openai'
creatorcrawl reddit subreddit-posts programming| Platform | Command groups |
|---|---|
| TikTok | profiles, videos, comments, transcripts, users, search, trending, songs |
| profiles, posts, reels, comments, transcripts, highlights | |
| YouTube | channels, videos, shorts, comments, transcripts, playlists, search |
| profiles, companies, company posts, posts, ads | |
| X and Reddit | profiles, tweets, communities, subreddits, posts, comments, search |
Hosted MCP
Add one URL. Sign in. Start prompting.
CreatorCrawl exposes its social-data operations as tools over Streamable HTTP. Your MCP client opens a browser for CreatorCrawl sign-in and authorization, then stores and refreshes OAuth tokens for you. There is no API key to create, copy, or paste.
MCP endpoint
https://app.creatorcrawl.com/api/mcp claude mcp add creatorcrawl \
--transport http \
"https://app.creatorcrawl.com/api/mcp"
# Then run /mcp in Claude Code and choose Authenticatecodex mcp add creatorcrawl \
--url "https://app.creatorcrawl.com/api/mcp"
codex mcp login creatorcrawl \
--scopes mcp,offline_access{
"mcpServers": {
"creatorcrawl": {
"url": "https://app.creatorcrawl.com/api/mcp"
}
}
}REST API
Full control for custom agent systems
Use REST when your code decides which calls to make, where results are stored, and how retries or multi-step jobs run. Every response is structured JSON and every interface uses the same account and credit balance.
curl "https://app.creatorcrawl.com/api/tiktok/profile?handle=khaby.lame" \
-H "x-api-key: YOUR_API_KEY"x-api-key header. Keep the key server-side and never
expose it in browser code.
Integration map
Pick the shortest path for your agent
| Agent environment | Recommended route | How it connects |
|---|---|---|
| Codex | MCP or CLI + skill | Add the hosted MCP URL and run codex mcp login, or install the CLI and skill. |
| Claude Code | CLI + skill or MCP | Use the installer for shell workflows, or register the hosted MCP endpoint. |
| Claude Desktop | MCP | Add the URL under Settings > Connectors, then click Connect and authorize in your browser. |
| Cursor | MCP | Add the URL without headers. Cursor opens the CreatorCrawl OAuth flow automatically. |
| Custom agents | REST API or MCP | Use REST for explicit orchestration or MCP for model-directed tool selection. |
Prompts to try
Ask for the outcome, not the endpoint
- Find ten fitness creators on TikTok, pull their five most popular videos, and rank them by median engagement.
- Compare how this company positions itself across LinkedIn posts, YouTube videos, and X.
- Pull the comments from this video and group the objections, questions, and purchase signals.
- Find this week's fastest-growing topics across Reddit and YouTube, with source URLs.
Authentication and credits
One account across every interface
Start with 50 free credits. CLI, MCP, and REST calls draw from the same balance, and credits never expire. MCP uses browser-based OAuth by default, so your client never needs an API key. Most operations cost one credit.
Frequently asked questions
- Should I use the CLI, MCP server, or REST API?
- Use the CLI and agent skill for Codex, Claude Code, terminal work, and repeatable research. Use MCP when your AI client can discover and call tools itself. Use the REST API when your application owns the orchestration, storage, and error handling.
- Does CreatorCrawl work with Codex and Claude Code?
- Yes. The installer adds the CreatorCrawl CLI and agent skill for supported agent environments. Both Codex and Claude Code can run the CLI, inspect its JSON output, and combine multiple calls into a research workflow. Claude Code can also connect through MCP.
- Do CLI, MCP, and API calls use different credits?
- No. They use the same account, endpoint costs, and credit balance. MCP clients can connect with OAuth, while REST integrations can continue using API keys.