Agent setup
Connect your agent
Choose a skill, standalone CLI, or hosted MCP connection for live TikTok, Instagram, YouTube, LinkedIn, X, and Reddit data.
Option 1
Install the agent skill
Install the skill to teach your agent how to call the REST API directly. It includes endpoint references and research workflows. Configure an API key in your agent environment to start.
npx skills add creatorcrawl/creatorcrawl-skill Choose your agent
Set your API key
Ask your agent
Node.js is required to run the skill installer. Choose your agent and install for the current project,
or add --global for use across projects.
Create an API key in CreatorCrawl's app
and configure CREATORCRAWL_API_KEY in your agent environment.
The skill uses standard HTTP requests; it does not install a terminal command.
Standalone CLI
Use CreatorCrawl in your terminal
Install the CLI separately, then run creatorcrawl directly.
Sign in through your browser; no API key required. The CLI installer does not install the skill.
macOS and Linux
curl -fsSL https://creatorcrawl.com/install.sh | sh
creatorcrawl auth login
creatorcrawl tiktok profile khaby.lame
Sets up Node.js if needed and installs into ~/.local/bin.
Follow the installer's PATH instructions if your shell cannot find the command.
Run with npx on macOS, Linux, or Windows
npx --yes --package=https://github.com/creatorcrawl/cli/releases/download/v0.4.2/creatorcrawl-0.4.2.tgz creatorcrawl --help
Node.js 18 or newer is required. This uses the verified GitHub release while the updated npm package awaits publication.
For a persistent command, run npm install -g https://github.com/creatorcrawl/cli/releases/download/v0.4.2/creatorcrawl-0.4.2.tgz.
CLI documentation.
Option 2
Add the MCP server
Add this URL to your MCP app, then sign in through the browser. No API key or headers.
https://app.creatorcrawl.com/api/mcp codex mcp add creatorcrawl --url https://app.creatorcrawl.com/api/mcp
codex mcp login creatorcrawl claude mcp add creatorcrawl \
--transport http https://app.creatorcrawl.com/api/mcp
Then run /mcp and choose Authenticate.
Claude web, mobile, and Desktop
On claude.ai, open Customize → Connectors → Add custom connector, paste the URL, and connect. Use the same account on mobile and enable CreatorCrawl in the chat's connectors.
Cursor or another MCP app
Add a remote MCP server named CreatorCrawl and paste the URL. Leave headers empty.
That’s it
After configuring API access or signing in through MCP, ask your agent for the social data you need in plain English.
Try this
“Find 10 fast-growing fitness creators on TikTok and rank them by engagement.”
Quick answers
- Which option should I use?
- Install the skill for Codex, Claude Code, Cursor, or another coding agent. It includes API instructions, endpoint references, and research workflows. Install the standalone CLI separately for terminal use. Use remote MCP for Claude mobile, Claude Desktop, or any app that supports MCP connectors.
- Do I need an API key?
- The API-only skill uses an API key configured in your agent environment. The standalone CLI and MCP use browser sign-in without an API key.
- What does the installer add?
- The skill installer adds instructions, six platform endpoint references, an API behavior guide, and five research workflows. It does not install the CLI or configure MCP. The CLI has a separate installer.
Building a custom integration? Open the REST API docs.