ScrapeCreators MCP Server & CLI

A free, open source ScrapeCreators MCP server and CLI that lets Claude Code, Codex, Cursor and other AI agents research public profiles, posts, transcripts and ads across social platforms.

githubStar on GitHubnpmnpm
Navid Moazzezby Navid Moazzez·Updated Oct 5, 2026·23 min read·
MCPCLI
Your computer
macOSWindowsLinux
  1. 1

    Add it with a single command in a terminal.

    Put your own API key in place of the example.

    claude mcp add scrapecreators \
      -e SCRAPECREATORS_API_KEY=YOUR_API_KEY \
      -- npx -y @thenavidm/scrapecreators-mcp-cli@latest
  2. 2

    In Claude Code, type /mcp. ScrapeCreators should show as connected.

    /mcp

Needs Node 22 or newer and a ScrapeCreators API key. New accounts get 100 free credits. Get your key in a minute.

It's free and open source. If it saves you time, star it on GitHub, so more people find it.

Rate this tool

This free ScrapeCreators MCP server and CLI gives your AI real access to public data from TikTok, Instagram, YouTube, Facebook, LinkedIn, X, Reddit and more, through ScrapeCreators. It reads public profiles, posts, comments and transcripts, searches ad libraries and TikTok Shop, and checks your credit balance and usage.

It's one install with two ways in. Claude, Codex, Cursor or any other MCP app calls its 190 tools for you, and the same tools work as a CLI that agents like Claude Code, Codex and OpenCode run, or that you type yourself.

In this guide, I'll show you:

  • What the ScrapeCreators MCP server & CLI is, and what you can ask it
  • How to install it and check that it works
  • When to use the MCP server, and when the CLI
  • Every tool, and how to keep your account safe

Every tool on this page comes from the server itself, and every cost was measured in Claude Code.

key_takeaways.mdTL;DR

Key takeaways

It gives Claude, Codex, Cursor and any other MCP app 190 tools for ScrapeCreators: public profiles, posts, comments, transcripts and ads from TikTok, Instagram, YouTube, Facebook, LinkedIn, X and many more platforms.
Most lookups cost one ScrapeCreators credit, and every lookup waits for your approval, so nothing spends credits by surprise.
A new ScrapeCreators account starts with 100 free credits and needs no card, and credits you buy never expire.
The same tools run as a CLI, which costs your AI nothing until it runs.

What is the ScrapeCreators MCP server & CLI?

The ScrapeCreators MCP server & CLI is a free, open source program that lets AI agents research public social media data through ScrapeCreators for you, in two ways. The MCP server is what an AI app like Claude, Codex or Cursor connects to, through MCP (Model Context Protocol), the open standard AI apps use to call outside tools.

You ask in plain language. Your AI picks the right tool, and the server makes the call to ScrapeCreators' own API.

The CLI is the same program as commands. scrapecreators-cli tiktok-profile runs the same code your AI runs when you ask about a TikTok creator, whether an agent like Claude Code runs it or you do.

In an AI OS, the layer that connects your AI to your context, your data and your tools, a server like this is how your AI reaches ScrapeCreators. My guide to building an AI operating system names ScrapeCreators among the tools it reaches, and here's how I use AI myself.

What can you ask it?

Once it's set up, you ask the way you'd ask an assistant. These are real prompts it handles:

Try asking
Pull the profile and the latest posts for this TikTok creator.
Get the transcript of this YouTube video in its original language.
Which ads is Notion running in the Meta Ad Library right now?
Find this creator's profiles on other platforms.
What are the top comments on this Instagram reel?
How many credits do I have left, and what used the most this week?

The third one shows why this is useful. Your AI reads a company's running ads straight from the ad library, so you see their angles without scrolling through them yourself.

It works well next to my YouTube MCP server and Facebook Ad Library MCP server, so your AI can manage your own YouTube channel and see every ad a brand runs in the same chat. Every server I've made is on my MCP servers page.

For your research, my free creator finder and engagement rate calculator help too.

How to install the ScrapeCreators MCP server

Pick your app in the box at the top of this page. Each one is a single command or a pasted block, and they all run through npx, so there's nothing to install first.

Windsurf, Zed and Cline take the same server, though they don't have a tab in the box yet. Follow the box's Cursor tab, and put its block here instead:

AppWhere the block goes
WindsurfIn the Cascade panel, open the Actions menu (…) and choose Open MCP config file, then paste the block.
ClineClick the MCP Servers icon in the Cline panel, open the Configure tab, click Configure MCP Servers, and paste the block.
ZedGo to Settings, then AI, then MCP Servers, and choose Add Server, then Add Local Server. Enter the block's command, arguments and variables, and Zed saves them under context_servers.
Before you start0/3

Watch out: Every lookup asks first, because it can spend credits, even though it only reads public data. A cached result is free, so your AI uses a recent cached copy where one will do.

Set up your ScrapeCreators account

It takes a minute.

Get your API key0/4

Most lookups cost one credit, and a few cost more: TikTok audience demographics cost 26, and finding a creator's other profiles costs 10. A cached result costs nothing, so a lookup with cache_max_age set to 7d reuses data up to a week old.

Credits you buy never expire, and ScrapeCreators sets no rate limit.

To keep the key out of your app's config, save it alone in a file only you can read, and point SCRAPECREATORS_TOKEN_FILE at that file's full path instead.

Check that it works

Run the doctor with --network. It checks your settings, then reads your credit balance to prove the key works. That read is free.

npx -y @thenavidm/scrapecreators-mcp-cli doctor --network

When every line has a check mark, restart your app and ask it how many credits you have. A 401 or 403 means the key was mistyped or replaced.

In Claude Code, /mcp also shows whether the ScrapeCreators server is connected. It's one of the Claude Code commands worth knowing.

Use the ScrapeCreators CLI

The CLI is the same 190 tools as commands. AI agents that run commands, like Claude Code, Codex and OpenCode, use it on their own, and you can type the same commands in a terminal or a script.

Every tool name becomes a command with dashes, so tiktok_profile runs as scrapecreators-cli tiktok-profile.

npm install -g @thenavidm/scrapecreators-mcp-cli
scrapecreators-cli
scrapecreators-cli scrapecreators-get-credit-balance
scrapecreators-cli tiktok-profile --handle example --cache-max-age 7d --confirm
scrapecreators-cli youtube-transcript --url https://www.youtube.com/watch?v=VIDEO_ID --original-audio --confirm
scrapecreators-cli facebook-ad-library-search --query notion --country US --status ACTIVE --confirm

The bare scrapecreators-cli lists every command, scrapecreators-cli which <words> finds the command for a task, and scrapecreators-cli <command> --help shows what a command takes. Every lookup needs --confirm, the terminal's version of your approval, because it can spend credits.

scrapecreators-cli install <app> adds the server to Claude Code, Codex, Claude Desktop, Cursor, VS Code or Gemini CLI, in each app's own format.

These are the flags you'll use most:

FlagWhat it does
--jsonPrints JSON
--compactPrints the JSON on one line
--select a,b.cKeeps only those fields, and a dotted path goes deeper
--agentMachine mode: compact JSON, no prompts, and it never confirms anything
--confirmLets a write that asks first go ahead
--dry-runShows what a write would do, without doing it

A script can branch on the exit code:

Exit codeWhat it means
0It worked
1Something unexpected went wrong
2The command was typed wrong, or a write needed --confirm
3It wasn't found
4ScrapeCreators rejected the credentials
5ScrapeCreators failed or couldn't be reached
7You hit a rate limit, so wait and try again
10Nothing is set up yet

MCP server or CLI: which one?

Both are the same program with the same 190 tools. The difference is when your AI pays for them, in the tokens it reads.

Every message, in an app that loads every tool
MCP server
88,400 tokens
CLI
Nothing
Every message, in Claude Code
MCP server
3,200 tokens
CLI
Nothing
When ScrapeCreators comes up
MCP server
Nothing more, or in Claude Code the tools it picks
CLI
1,400 tokens, once
20 messages with ScrapeCreators in one, every tool loaded
MCP server
1,768,000 tokens
CLI
1,400 tokens
Works in Claude Desktop's chat
MCP server
Yes
CLI
No, there's no terminal there
Works in a script, a cron job or CI
MCP server
No
CLI
Yes

An app that loads every tool up front sends the full list with every message, whether you mention ScrapeCreators or not. Claude Code doesn't by default: its tool search sends only the tool names and the server's instructions, and loads a tool's full definition when your AI reaches for it.

The CLI costs nothing until ScrapeCreators comes up. Then your agent reads its skill file once and runs the commands it needs. With the skill added, Claude Code also lists its one-line description with every message, about 50 tokens.

When the whole conversation is about ScrapeCreators, the gap closes. Then the MCP server is the better experience, because you ask in plain language and your AI never has to look up a command.

How to spend less

In Claude Code, leave tool search on, which it is unless you've set ENABLE_TOOL_SEARCH=false.

Turn the server off when you aren't researching. In Claude Code that's the /mcp panel, and every AI app has its own switch. SCRAPECREATORS_READ_ONLY=1 cuts it to the five free account tools.

Or install the CLI and connect the server later, on the days it earns its place. Every tool stays in reach, and the standing cost drops to nothing.

Every number here was measured on October 5, 2026 in Claude Code 2.1.286 with Claude Opus 5.5. It's the same one-line prompt with and without the server connected, once with tool search off so every tool loads, and once with Claude Code's default. The skill was measured the same way, and other apps and models count tokens a little differently.

Credits, caching and pages

Each lookup reads public data, and most cost one credit. The response says how many credits it used and whether it came from the cache, and a cached result is free.

Lists come a page at a time, with each platform's own page token. Your AI asks before each new page, since every page is another lookup.

research_batch runs up to 20 lookups in a row, all checked before the first one starts. It stops at the first failure and keeps the results it already has.

Transcripts depend on the video. When a YouTube video has no caption track in the language you asked for, the answer is empty and costs nothing.

Watch out: A lookup that times out may still have spent its credit, and the server never retries one on its own. Check your request history before you ask again.

Every ScrapeCreators tool

The tables below list all 190 tools, grouped by platform. Of these, 185 look up public data and spend credits, and five are free reads of your own account.

TikTok and TikTok Shop

tiktok_profile
What it does
Reads public profile data for a TikTok user by their handle or user ID.
Cost
Credits, asks first
tiktok_profile_region
What it does
Reads the country code for a public TikTok profile, like US or MX.
Cost
Credits, asks first
tiktok_audience_demographics
What it does
Reads where a TikTok user's followers live, by country, for 26 credits.
Cost
Credits, asks first
tiktok_collection_videos
What it does
Reads the videos saved in a public TikTok collection, which TikTok also calls a playlist.
Cost
Credits, asks first
tiktok_profile_videos
What it does
Reads a TikTok user's videos, by latest or most popular.
Cost
Credits, asks first
tiktok_video_info
What it does
Reads detailed data for a single TikTok video by URL.
Cost
Credits, asks first
tiktok_transcript
What it does
Extracts existing transcripts, captions, or subtitles from a TikTok video by URL.
Cost
Credits, asks first
tiktok_live
What it does
Checks whether a TikTok user is live right now.
Cost
Credits, asks first
tiktok_live_info
What it does
Reads the details of a TikTok live room.
Cost
Credits, asks first
tiktok_comments
What it does
Reads comments on a TikTok video by URL.
Cost
Credits, asks first
tiktok_comment_replies
What it does
Reads replies to a specific TikTok comment by its ID.
Cost
Credits, asks first
tiktok_following
What it does
Reads the accounts a TikTok user follows.
Cost
Credits, asks first
tiktok_followers
What it does
Reads the follower list of a TikTok account by handle or user ID.
Cost
Credits, asks first
tiktok_search_users
What it does
Searches for TikTok users by keyword or name.
Cost
Credits, asks first
tiktok_search_suggestions
What it does
Reads the autocomplete suggestions TikTok shows while someone is typing in search.
Cost
Credits, asks first
tiktok_search_by_hashtag
What it does
Searches for TikTok videos under a specific hashtag.
Cost
Credits, asks first
tiktok_search_by_keyword
What it does
Searches for TikTok videos by keyword or phrase.
Cost
Credits, asks first
tiktok_top_search
What it does
Searches TikTok's 'Top' results by query.
Cost
Credits, asks first
tiktok_get_popular_creators
What it does
Finds popular TikTok creators, by follower count and country.
Cost
Credits, asks first
tiktok_get_song_details
What it does
Reads detailed metadata for a specific TikTok sound or song by its clipId.
Cost
Credits, asks first
tiktok_tiktoks_using_song
What it does
Reads the TikTok videos that use a sound.
Cost
Credits, asks first
tiktok_trending_feed
What it does
Reads TikTok's trending feed for a region.
Cost
Credits, asks first
tiktok_shop_shop_search
What it does
Searches TikTok Shop for products by keyword.
Cost
Credits, asks first
tiktok_shop_shop_products
What it does
Lists the products in a TikTok Shop store.
Cost
Credits, asks first
tiktok_shop_product_details
What it does
Reads full details for a specific US TikTok Shop product by its URL.
Cost
Credits, asks first
tiktok_shop_product_reviews
What it does
Reads customer reviews for a TikTok Shop product by URL or product ID.
Cost
Credits, asks first
tiktok_shop_user_showcase
What it does
Reads the products in a TikTok user's showcase.
Cost
Credits, asks first

Instagram and Threads

instagram_profile
What it does
Reads a public Instagram profile, with its bio, links and counts.
Cost
Credits, asks first
instagram_basic_profile
What it does
Reads a short Instagram profile summary by user ID.
Cost
Credits, asks first
instagram_posts
What it does
Reads a paginated feed of a user's public Instagram posts.
Cost
Credits, asks first
instagram_user_tagged_posts
What it does
Reads up to 10 public posts per page from an Instagram user's tagged tab.
Cost
Credits, asks first
instagram_reels
What it does
Reads a paginated list of a user's public Instagram reels.
Cost
Credits, asks first
instagram_post_reel_info
What it does
Reads detailed metadata for a single Instagram post or reel by shortcode or URL.
Cost
Credits, asks first
instagram_transcript
What it does
Transcribes an Instagram video or reel with AI.
Cost
Credits, asks first
instagram_search_instagram
What it does
Looks up Instagram accounts, hashtags or places.
Cost
Credits, asks first
instagram_popular_search
What it does
Explores an Instagram topic and the posts Instagram picks for it.
Cost
Credits, asks first
instagram_search_hashtag_posts
What it does
Finds public Instagram posts and reels for an exact hashtag, through Google's index.
Cost
Credits, asks first
instagram_search_instagram_profiles
What it does
Looks up Instagram profiles.
Cost
Credits, asks first
instagram_search_reels
What it does
Finds public Instagram reels by keyword, through Google's index.
Cost
Credits, asks first
instagram_get_reels_by_audio_id
What it does
Reads the reels that use an Instagram audio track.
Cost
Credits, asks first
instagram_trending_reels
What it does
Reads trending reels from Instagram's public instagram.com/reels page.
Cost
Credits, asks first
instagram_comments
What it does
Reads comments on a public Instagram post or reel.
Cost
Credits, asks first
instagram_comment_replies
What it does
Reads the public replies to a specific Instagram comment.
Cost
Credits, asks first
instagram_story_highlights
What it does
Lists all story highlight albums for an Instagram user.
Cost
Credits, asks first
instagram_highlights_details
What it does
Reads the full contents of a specific Instagram story highlight album by its ID.
Cost
Credits, asks first
instagram_profile_post_count
What it does
Reads the post count shown on a public Instagram profile.
Cost
Credits, asks first
instagram_embed_html
What it does
Reads the raw HTML embed snippet for an Instagram user's profile widget.
Cost
Credits, asks first
threads_profile
What it does
Reads a Threads user's public profile.
Cost
Credits, asks first
threads_posts
What it does
Reads the most recent posts from a Threads user.
Cost
Credits, asks first
threads_post
What it does
Reads a single Threads post by URL.
Cost
Credits, asks first
threads_search_by_keyword
What it does
Searches Threads for posts matching a keyword.
Cost
Credits, asks first
threads_search_users
What it does
Searches for Threads users by username.
Cost
Credits, asks first

YouTube

youtube_channel_details
What it does
Reads a YouTube channel's profile, with its subscriber count.
Cost
Credits, asks first
youtube_channel_videos
What it does
Reads a paginated list of videos uploaded by a YouTube channel.
Cost
Credits, asks first
youtube_channel_playlists
What it does
Reads playlists from a YouTube channel's playlists tab.
Cost
Credits, asks first
youtube_channel_lives
What it does
Reads live streams and past streams from a YouTube channel's live tab.
Cost
Credits, asks first
youtube_channel_community_posts
What it does
Reads community posts from a YouTube channel's posts tab.
Cost
Credits, asks first
youtube_channel_shorts
What it does
Lists a YouTube channel's shorts.
Cost
Credits, asks first
youtube_video_short_details
What it does
Reads full details for a YouTube video or short.
Cost
Credits, asks first
youtube_transcript
What it does
Reads publicly available captions, subtitles, or transcripts from a YouTube video or short.
Cost
Credits, asks first
youtube_video_sponsors
What it does
Reads a YouTube video's sponsors, as an experiment.
Cost
Credits, asks first
youtube_search
What it does
Searches YouTube for videos, channels, playlists and shorts.
Cost
Credits, asks first
youtube_search_typeahead
What it does
Reads the live search suggestions YouTube displays while a user types.
Cost
Credits, asks first
youtube_search_by_hashtag
What it does
Searches YouTube by hashtag.
Cost
Credits, asks first
youtube_comments
What it does
Reads comments and replies from a YouTube video.
Cost
Credits, asks first
youtube_comment_replies
What it does
Reads replies to a specific comment on a YouTube video.
Cost
Credits, asks first
youtube_trending_shorts
What it does
Reads YouTube's currently trending shorts.
Cost
Credits, asks first
youtube_playlist
What it does
Reads all videos in a YouTube playlist.
Cost
Credits, asks first
youtube_community_post_details
What it does
Reads the full details of a YouTube community post.
Cost
Credits, asks first

Facebook, Marketplace and events

facebook_profile
What it does
Reads a public Facebook page's details, like its category, contact details and rating.
Cost
Credits, asks first
facebook_profile_reels
What it does
Reads up to 10 reels per request from a public Facebook page.
Cost
Credits, asks first
facebook_profile_photos
What it does
Reads photos from a public Facebook page.
Cost
Credits, asks first
facebook_profile_posts
What it does
Reads a public Facebook profile's posts, 3 at a time.
Cost
Credits, asks first
facebook_profile_events
What it does
Reads a public Facebook page's events.
Cost
Credits, asks first
facebook_post
What it does
Reads a single public Facebook post or reel by URL.
Cost
Credits, asks first
facebook_transcript
What it does
Extracts the transcript text from a Facebook video post or reel.
Cost
Credits, asks first
facebook_comments
What it does
Reads the comments on a Facebook post or reel.
Cost
Credits, asks first
facebook_comment_replies
What it does
Reads the replies to a comment.
Cost
Credits, asks first
facebook_facebook_group_info
What it does
Reads a public Facebook group's about page.
Cost
Credits, asks first
facebook_facebook_group_posts
What it does
Reads a public Facebook group's posts, 3 at a time.
Cost
Credits, asks first
facebook_marketplace_marketplace_location_search
What it does
Finds Facebook Marketplace locations, for searching near them.
Cost
Credits, asks first
facebook_marketplace_marketplace_search
What it does
Searches Facebook Marketplace listings near a place.
Cost
Credits, asks first
facebook_marketplace_marketplace_item
What it does
Reads details for a Facebook Marketplace item by item ID or Marketplace item URL.
Cost
Credits, asks first
facebook_events_search_events
What it does
Searches for events by name.
Cost
Credits, asks first
facebook_events_events
What it does
Reads the events in a city.
Cost
Credits, asks first
facebook_events_event_details
What it does
Reads one Facebook event by its link or ID.
Cost
Credits, asks first

Ad libraries: Meta, TikTok, Google and LinkedIn

facebook_ad_library_ad_details
What it does
Reads detailed information about a specific Facebook ad by its ID or URL.
Cost
Credits, asks first
facebook_ad_library_ad_transcript
What it does
Reads a transcript for a single Facebook Ad Library video ad by ID or URL.
Cost
Credits, asks first
facebook_ad_library_search
What it does
Searches the Meta Ad Library by keyword and returns matching ads.
Cost
Credits, asks first
facebook_ad_library_search_post
What it does
Searches the Meta Ad Library, with a JSON body for longer queries.
Cost
Credits, asks first
facebook_ad_library_company_ads
What it does
Reads all ads currently running for a specific company from the Meta Ad Library.
Cost
Credits, asks first
facebook_ad_library_company_ads_post
What it does
Reads a company's running ads in the Meta Ad Library, with a JSON body.
Cost
Credits, asks first
facebook_ad_library_search_for_companies
What it does
Searches the Meta Ad Library for companies by name, for their page IDs.
Cost
Credits, asks first
tiktok_ad_library_ad_library_search
What it does
Searches TikTok's ad library by keyword or advertiser.
Cost
Credits, asks first
tiktok_ad_library_ad_library_ad
What it does
Reads one TikTok ad by ID or URL.
Cost
Credits, asks first
google_ad_library_company_ads
What it does
Reads a company's ads from Google's Ads Transparency Center.
Cost
Credits, asks first
google_ad_library_ad_details
What it does
Reads one ad from Google's Ads Transparency Center.
Cost
Credits, asks first
google_ad_library_advertiser_search
What it does
Searches Google's Ads Transparency Center for advertisers.
Cost
Credits, asks first
linkedin_ad_library_search_ads
What it does
Searches the LinkedIn Ad Library by company or keyword, with country and date filters.
Cost
Credits, asks first
linkedin_ad_library_ad_details
What it does
Reads detailed information about a specific LinkedIn ad by URL.
Cost
Credits, asks first

X, Bluesky and Truth Social

twitter_profile
What it does
Reads a Twitter user's profile by handle.
Cost
Credits, asks first
twitter_user_tweets
What it does
Reads tweets from a Twitter user's profile by handle.
Cost
Credits, asks first
twitter_tweet_details
What it does
Reads detailed information about a specific tweet by URL.
Cost
Credits, asks first
twitter_transcript
What it does
Transcribes an X video post with AI.
Cost
Credits, asks first
twitter_community
What it does
Reads an X community.
Cost
Credits, asks first
twitter_community_tweets
What it does
Reads the posts in an X community.
Cost
Credits, asks first
truth_social_profile
What it does
Reads a Truth Social user's public profile.
Cost
Credits, asks first
truth_social_user_posts
What it does
Reads a paginated list of posts from a Truth Social user.
Cost
Credits, asks first
truth_social_post
What it does
Reads a single Truth Social post by URL.
Cost
Credits, asks first
bluesky_profile
What it does
Reads a Bluesky user's public profile.
Cost
Credits, asks first
bluesky_posts
What it does
Reads a paginated feed of posts from a Bluesky user.
Cost
Credits, asks first
bluesky_post
What it does
Reads a single Bluesky post by URL.
Cost
Credits, asks first

LinkedIn

linkedin_person_profile
What it does
Reads a person's public LinkedIn profile data.
Cost
Credits, asks first
linkedin_company_page
What it does
Reads a LinkedIn company page with details.
Cost
Credits, asks first
linkedin_company_posts
What it does
Reads paginated posts from a LinkedIn company page.
Cost
Credits, asks first
linkedin_search_posts
What it does
Finds public LinkedIn posts and articles by keyword, through Google Search.
Cost
Credits, asks first
linkedin_post
What it does
Reads a single LinkedIn post or article.
Cost
Credits, asks first
linkedin_post_transcript
What it does
Reads the transcript from a LinkedIn post video when LinkedIn exposes one publicly.
Cost
Credits, asks first

Reddit, Pinterest and Snapchat

reddit_subreddit_details
What it does
Reads a subreddit's details.
Cost
Credits, asks first
reddit_subreddit_posts
What it does
Reads posts from a subreddit with sorting and filtering options.
Cost
Credits, asks first
reddit_subreddit_search
What it does
Searches inside one subreddit.
Cost
Credits, asks first
reddit_post
What it does
Reads a public Reddit post by URL, without its comments.
Cost
Credits, asks first
reddit_post_comments
What it does
Reads comments and post details from a Reddit post by URL.
Cost
Credits, asks first
reddit_post_comments_post
What it does
Reads a Reddit post and its comments, with a JSON body.
Cost
Credits, asks first
reddit_post_transcript
What it does
Reads a Reddit video's transcript, when Reddit has captions for it.
Cost
Credits, asks first
reddit_search
What it does
Searches all of Reddit for posts or comments.
Cost
Credits, asks first
pinterest_search
What it does
Searches Pinterest for pins.
Cost
Credits, asks first
pinterest_pin
What it does
Reads one Pinterest pin.
Cost
Credits, asks first
pinterest_user_boards
What it does
Reads a paginated list of boards for a Pinterest user.
Cost
Credits, asks first
pinterest_board
What it does
Reads a paginated list of pins from a Pinterest board by URL.
Cost
Credits, asks first
snapchat_user_profile
What it does
Reads a Snapchat user's public profile by handle.
Cost
Credits, asks first
snapchat_spotlight_by_link
What it does
Reads public data for a Snapchat spotlight video by URL.
Cost
Credits, asks first
snapchat_spotlight_comments_by_link
What it does
Reads the comments on a Snapchat Spotlight video.
Cost
Credits, asks first

Twitch, Kick, Rumble and Kwai

rumble_search
What it does
Searches Rumble videos by keyword.
Cost
Credits, asks first
rumble_channel_videos
What it does
Reads videos from a Rumble channel by handle or URL.
Cost
Credits, asks first
rumble_video
What it does
Reads Rumble video details by URL.
Cost
Credits, asks first
rumble_transcript
What it does
Reads a Rumble video's transcript when captions are available.
Cost
Credits, asks first
rumble_comments
What it does
Reads all top level comments for a Rumble video by URL.
Cost
Credits, asks first
twitch_profile
What it does
Reads a Twitch user's public profile by handle.
Cost
Credits, asks first
twitch_user_videos
What it does
Lists a Twitch user's videos.
Cost
Credits, asks first
twitch_user_schedule
What it does
Reads a user's schedule by handle.
Cost
Credits, asks first
twitch_clip_transcript
What it does
Reads a transcript from a public Twitch clip.
Cost
Credits, asks first
twitch_clip
What it does
Reads detailed data for a Twitch clip by URL.
Cost
Credits, asks first
kwai_profile
What it does
Reads a public Kwai profile.
Cost
Credits, asks first
kwai_user_posts
What it does
Reads a paginated list of public Kwai posts for a user.
Cost
Credits, asks first
kwai_post
What it does
Reads public Kwai post details.
Cost
Credits, asks first
kick_clip_transcript
What it does
Reads a transcript from a public Kick clip.
Cost
Credits, asks first
kick_clip
What it does
Reads detailed data for a Kick clip by URL.
Cost
Credits, asks first

Spotify, Apple Music and SoundCloud

apple_music_artist
What it does
Reads public Apple Music artist details.
Cost
Credits, asks first
apple_music_album
What it does
Reads public Apple Music album details.
Cost
Credits, asks first
apple_music_track
What it does
Reads public Apple Music song details by ID or URL.
Cost
Credits, asks first
apple_music_search
What it does
Searches Apple Music.
Cost
Credits, asks first
spotify_artist
What it does
Reads detailed information about a Spotify artist by their handle.
Cost
Credits, asks first
spotify_track
What it does
Reads detailed information about a Spotify track by its ID or URL.
Cost
Credits, asks first
spotify_album
What it does
Reads detailed information about a Spotify album by its ID or URL.
Cost
Credits, asks first
spotify_playlist
What it does
Reads public Spotify playlist metadata and up to 50 tracks by playlist ID or URL.
Cost
Credits, asks first
spotify_search
What it does
Searches Spotify for tracks, artists, albums, podcasts and audiobooks.
Cost
Credits, asks first
spotify_podcast
What it does
Reads detailed information about a Spotify podcast by its ID or URL.
Cost
Credits, asks first
spotify_podcast_episodes
What it does
Reads episodes for a Spotify podcast.
Cost
Credits, asks first
soundcloud_artist
What it does
Reads detailed information about a SoundCloud artist by its handle or URL.
Cost
Credits, asks first
soundcloud_artist_tracks
What it does
Reads tracks/songs for a SoundCloud artist by handle or URL.
Cost
Credits, asks first
soundcloud_track
What it does
Reads detailed information about a SoundCloud track/song by URL.
Cost
Credits, asks first

GitHub, Google and Telegram

telegram_channel_details
What it does
Reads public Telegram channel or group metadata.
Cost
Credits, asks first
telegram_channel_posts
What it does
Reads one page of a public Telegram channel's posts.
Cost
Credits, asks first
telegram_post_details
What it does
Reads one public Telegram post.
Cost
Credits, asks first
github_user
What it does
Reads public GitHub user details.
Cost
Credits, asks first
github_repositories
What it does
Reads a GitHub user's public repositories.
Cost
Credits, asks first
github_pull_requests
What it does
Searches a GitHub user's public pull requests.
Cost
Credits, asks first
github_activity
What it does
Reads a GitHub user's public activity.
Cost
Credits, asks first
github_followers
What it does
Reads public GitHub followers for a user.
Cost
Credits, asks first
github_following
What it does
Reads the accounts a GitHub user follows.
Cost
Credits, asks first
github_contributions
What it does
Reads the public GitHub contribution graph for a user and year.
Cost
Credits, asks first
github_repository
What it does
Reads public metadata for one GitHub repository.
Cost
Credits, asks first
github_trending_repositories
What it does
Reads GitHub's trending repositories.
Cost
Credits, asks first
github_trending_developers
What it does
Reads GitHub's trending developers.
Cost
Credits, asks first
google_search
What it does
Searches Google and returns the organic results.
Cost
Credits, asks first
creator_tools_find_social_profiles
What it does
Finds a creator's profiles on other platforms from one handle, for 10 credits.
Cost
Credits, asks first
creator_tools_get_age_and_gender
What it does
Estimates a creator's age and gender from their profile photo, with AI.
Cost
Credits, asks first
linktree_linktree_page
What it does
Reads a Linktree page and all its links.
Cost
Credits, asks first
komi_komi_page
What it does
Reads a Komi page and its links.
Cost
Credits, asks first
pillar_pillar_page
What it does
Reads a Pillar page, with its links and products.
Cost
Credits, asks first
linkbio_linkbio_page
What it does
Reads a Linkbio page and its links.
Cost
Credits, asks first
amazon_shop_amazon_shop_page
What it does
Reads a creator's Amazon storefront and its collections.
Cost
Credits, asks first
linkme_profile
What it does
Reads a Linkme profile by URL.
Cost
Credits, asks first

Your account and batches

scrapecreators_get_credit_balance
What it does
Reads how many credits you have left.
Cost
Free
scrapecreators_get_request_history
What it does
Lists your past lookups, with the credits each one used.
Cost
Free
scrapecreators_get_daily_usage
What it does
Shows your daily credit use for the last 30 days.
Cost
Free
scrapecreators_get_most_used_routes
What it does
Shows the lookups you've run most, and their credits.
Cost
Free
list_accounts
What it does
Lists the accounts you've set up, without their keys.
Cost
Free
research_batch
What it does
Runs up to 20 lookups in a row, checked before the first one starts.
Cost
Credits, asks first

Is the ScrapeCreators MCP server safe?

Nothing here posts, follows or messages anyone, and the server never logs in to a social account. The risk is spending credits, so all 185 lookups ask first, even though they only read public data.

When your AI calls one, a person approves it. Claude Code (2.1.246 and later) shows you its own prompt, and an app that can show forms asks you in one. Where an app can do neither, your AI's confirm: true counts, and SCRAPECREATORS_CONFIRM=model makes that enough everywhere, for an agent with no person to ask. In a terminal, it's --confirm.

Make it read-only

Set SCRAPECREATORS_READ_ONLY=1 and every lookup disappears from the tool list, leaving the five free reads of your account. SCRAPECREATORS_ALLOW_DESTRUCTIVE=0 keeps the lookups listed but refuses them, even approved. Set SCRAPECREATORS_AUDIT_LOG to a file path to get one line per lookup, allowed or blocked.

Watch out: Profiles, captions and comments are written by other people, and one can try to give your AI orders. Treat them as data, and never let returned text approve another lookup.

Your data

Your requests go straight to ScrapeCreators, with no server of ours in between and no tracking. Your key stays in your app's config, your shell or your token file.

The handles and links you look up go to ScrapeCreators, and what comes back is other people's public data. Keep it out of public places, and treat your request history as private too.

To cut access, delete or replace the key in ScrapeCreators' API Keys area, and remove the server from your app's config.

Connect more than one ScrapeCreators account

Set SCRAPECREATORS_ACCOUNTS to a JSON list with a name and a key, or a token file, for each account, and SCRAPECREATORS_DEFAULT_ACCOUNT to the one that acts when a tool names none. Every tool takes an optional account.

An account never borrows another one's key. Two names for the same key still share its credits.

ScrapeCreators MCP server settings

Every setting is an environment variable, in your app's config or your shell.

SCRAPECREATORS_API_KEY
Default
none
What it does
Holds your API key
SCRAPECREATORS_TOKEN_FILE
Default
none
What it does
Points at a private file holding the key, instead
SCRAPECREATORS_ACCOUNTS
Default
none
What it does
Lists several accounts, as JSON
SCRAPECREATORS_DEFAULT_ACCOUNT
Default
the first one
What it does
Picks the account that acts when a tool names none
SCRAPECREATORS_ALLOW_SPENDING
Default
on
What it does
The older name for SCRAPECREATORS_ALLOW_DESTRUCTIVE
SCRAPECREATORS_REQUEST_TIMEOUT_MS
Default
30000
What it does
Gives up on a ScrapeCreators request after this many milliseconds
SCRAPECREATORS_MAX_RETRIES
Default
2
What it does
Retries a rate-limited account read this many times, and never a lookup
SCRAPECREATORS_MIN_REQUEST_INTERVAL_MS
Default
150
What it does
Waits this many milliseconds between requests
SCRAPECREATORS_READ_ONLY
Default
off
What it does
1 hides every lookup that spends credits, leaving your account reads
SCRAPECREATORS_ALLOW_DESTRUCTIVE
Default
on
What it does
0 refuses every lookup that spends credits, even approved
SCRAPECREATORS_AUDIT_LOG
Default
none
What it does
Names a file that gets one line per attempted lookup
SCRAPECREATORS_SURFACE
Default
full
What it does
search lists three tools that find, describe and run the rest
SCRAPECREATORS_TOOL_TIMEOUT_MS
Default
none
What it does
Gives up on any tool after this many milliseconds
SCRAPECREATORS_CONFIRM
Default
human
What it does
model lets your AI's confirm: true approve on its own, for an agent with no person to ask
SCRAPECREATORS_HTTP_PORT
Default
8787
What it does
Sets the port for --http
SCRAPECREATORS_HTTP_HOST
Default
127.0.0.1
What it does
Sets the address for --http, and any other needs a token
SCRAPECREATORS_HTTP_TOKEN
Default
none
What it does
Sets the bearer token every --http request needs
SCRAPECREATORS_HTTP_ALLOWED_ORIGINS
Default
none
What it does
Lists other websites allowed to call --http, comma separated
SCRAPECREATORS_DEBUG
Default
off
What it does
1 prints debug lines

Troubleshooting

Run the doctor first. It names the step that failed and the fix.

What you seeWhat to do
A lookup is refusedIt needs your approval, or --confirm in a terminal, because it can spend credits
A 401 or 403 errorCheck the key in your ScrapeCreators dashboard, and that it's in SCRAPECREATORS_API_KEY
A transcript comes back emptyThe video has no caption track in that language. Try its original audio, and an empty answer costs nothing
Only the first page came backEach page is its own lookup. Ask for the next one with the page token the last one returned
A lookup timed outIt may have spent its credit. Check your request history before you try again
A batch stopped partwayIt keeps the results it has. Read the failed one, then run only the lookups that didn't happen
"…so it will not run without confirm: true"That's the safety check working. Approve it when your app asks

If the server doesn't show up in your app at all, run the command your app runs, in a terminal, and read the error.

More free tools for social research

Search Meta's ad library on its own, or work with your own YouTube channel.

Free tools

Creator finderEngagement rate calculatorSocial media post analyzerTikTok money calculatorInstagram money calculator

MCP servers

YouTube MCP server & CLIFacebook Ad Library MCP server & CLI

FAQs about the ScrapeCreators MCP server & CLI

Here are the questions people ask most about the ScrapeCreators MCP server and CLI.

The ScrapeCreators MCP server & CLI is a free, open source program that lets an AI app like Claude, Codex or Cursor research public social media data through ScrapeCreators.

It has 190 tools for public profiles, posts, comments, transcripts and ad libraries across social platforms, and the same tools run as a CLI that agents like Claude Code and Codex use, or that you type yourself.

An MCP server is a standard way to give an AI app real access to a tool, so it can act instead of guessing.

MCP stands for Model Context Protocol, and Claude, Codex, Cursor and many other AI apps speak it.

Every server I've made is on my MCP servers page.

The ScrapeCreators CLI is the same program as the ScrapeCreators MCP server, run as commands.

AI agents like Claude Code, Codex and OpenCode run them for you, and you can type them in a terminal or a script.

One npm package installs both.

Use the ScrapeCreators MCP server in an AI app with no terminal, like Claude Desktop's chat, and the CLI in a terminal, a script or a cron job.

In an AI app that can run commands, like Claude Code, Codex or Cursor, the CLI is the lighter choice, because it costs nothing until it runs.

Yes, the ScrapeCreators MCP server is free and open source under the AGPL-3.0-or-later license.

Lookups spend ScrapeCreators credits, and a new account starts with 100 free ones.

Most lookups cost one credit, and a few cost more, like TikTok audience demographics at 26.

A cached result is free, and reading your own balance and history is free too.

No, it only reads public data.

It never logs in to a social account, so it can't post, follow or message anyone.

Each lookup can spend credits, so the server waits for your approval, even though nothing changes.

SCRAPECREATORS_CONFIRM=model lets an agent with no person to ask approve on its own.

Yes, the ScrapeCreators MCP server connects as many accounts as you set up in SCRAPECREATORS_ACCOUNTS, each with its own key.

Every tool takes an optional account, and an account never borrows another one's key.

To disconnect the ScrapeCreators MCP server, delete or replace its key in ScrapeCreators' API Keys area, which cuts access right away.

Then remove the server from your AI app's config.

The ScrapeCreators MCP server works with any app that speaks MCP.

That includes Claude Code, Claude Desktop, Codex, Cursor, VS Code, Windsurf, Zed, Cline, GitHub Copilot CLI, Gemini CLI, OpenCode, OpenClaw, Antigravity and Hermes.

I did.

I'm Navid Moazzez, and I made the ScrapeCreators MCP server & CLI as one of my free tools on navid.me.

You can read more about me.

The code is on GitHub under the AGPL-3.0-or-later license, and the package is on npm.

More MCP servers & CLIs

View all

YouTube MCP server & CLI

Read any video's transcript, research channels and manage your own from Claude, Codex or Cursor.

VideoyoutubeYouTube

Facebook Ad Library MCP server & CLI

Research the ads any brand runs on Facebook and Instagram, from Claude, Codex or Cursor.

ResearchfacebookFacebook

TikTok MCP server & CLI

Rank your videos, read your stats and publish to TikTok from Claude, Codex or Cursor.

Social mediatiktokTikTok

Bluesky MCP server & CLI

Post, read and search Bluesky from Claude, Codex or Cursor, or from your terminal.

Social mediablueskyBluesky

Substack MCP server & CLI

Draft posts, publish Notes and check your stats on Substack from Claude, Codex or Cursor.

NewsletterssubstackSubstack

Threads MCP server & CLI

Post, reply and read your insights on Threads from Claude, Codex or Cursor.

Social mediathreadsThreads

Mastodon MCP server & CLI

Post, edit and read your timelines on any Mastodon instance from Claude, Codex or Cursor.

Social mediamastodonMastodon

ThriveCart MCP server & CLI

Check revenue, customers, subscriptions and affiliates in ThriveCart from Claude, Codex or Cursor.

SalesThriveCart

WordPress MCP server & CLI

Edit posts, pages, Elementor and Rank Math SEO on WordPress from Claude, Codex or Cursor.

BlogsWordPress

Midjourney MCP server & CLI

Generate images, follow jobs and download the files from Midjourney with Claude, Codex or Cursor.

AI imagesMidjourney

Google Photos MCP server & CLI

Pick photos, build albums and upload to Google Photos from Claude, Codex or Cursor.

PhotosGoogle Photos

Apple Photos MCP server & CLI

Search, look at and organize your Apple Photos library from Claude, Codex or Cursor, on your Mac.

PhotosApple Photos

Apple Podcasts MCP server & CLI

Track chart ranks, read reviews and search your podcast library from Claude, Codex or Cursor.

Podcastsapple-podcastsApple Podcasts

Podcast Index MCP server & CLI

Search 4 million podcasts and read episode transcripts from Claude, Codex or Cursor.

PodcastsPodcast Index

Google Search Console MCP server & CLI

Read your search traffic, check indexing and submit sitemaps from Claude, Codex or Cursor.

SEOGoogle Search Console

Google Workspace MCP server & CLI

Work across Gmail, Drive, Sheets, Docs and Calendar from Claude, Codex or Cursor.

ProductivityGoogle Workspace

iMessage MCP server & CLI

Catch up, search your history and send iMessages from Claude, Codex or Cursor, on your Mac.

MessagingiMessage

Facebook MCP server & CLI

Read your Page insights, schedule posts and moderate comments, from Claude, Codex or Cursor.

Social mediafacebookFacebook

Vimeo MCP server & CLI

Read transcripts, file videos into folders and add chapters from Claude, Codex or Cursor.

VideoVimeo

Telegram MCP server & CLI

Catch up, search years of chats and reply on Telegram from Claude, Codex or Cursor.

MessagingtelegramTelegram

Adobe Firefly MCP server & CLI

Generate and edit images with Image 5, make video and composite products from Claude, Codex or Cursor.

AI imagesAdobe Firefly

OP3 MCP server & CLI

Read your podcast's downloads, real listeners and retention from Claude, Codex or Cursor.

PodcastsOP3

Kit MCP server & CLI

Draft newsletters, manage subscribers and tags, and read your email stats from Claude, Codex or Cursor.

NewslettersKit

Beehiiv MCP server & CLI

Draft posts, manage subscribers and segments, and read your stats, from Claude, Codex or Cursor.

NewslettersBeehiiv

Circle MCP server & CLI

Manage members and spaces, draft posts, and run events and courses, from Claude, Codex or Cursor.

CommunitiesCircle

Calendly MCP server & CLI

Find open times, book and cancel meetings, and read meeting recaps, from Claude, Codex or Cursor.

SalesCalendly

Wistia MCP server & CLI

Upload and organize videos, fix captions and read your analytics, from Claude, Codex or Cursor.

VideoWistia

Shotstack MCP server & CLI

Render videos from templates, make AI clips and manage hosted files, from Claude, Codex or Cursor.

VideoShotstack

Gumloop MCP server & CLI

Run flows, work with your agents and search your Company Brain, from Claude, Codex or Cursor.

ProductivityGumloop

Buffer MCP server & CLI

Draft and schedule posts, manage your queues and read your analytics, from Claude, Codex or Cursor.

Social mediaBuffer

Cloudflare MCP server & CLI

Manage DNS records, clear the cache and change domain settings, from Claude, Codex or Cursor.

ProductivityCloudflare

Bannerbear MCP server & CLI

Make images, animations and videos from your templates, from Claude, Codex or Cursor.

AI imagesBannerbear

Brandfetch MCP server & CLI

Get any brand's logos, colors and fonts, and compare brands, from Claude, Codex or Cursor.

ResearchBrandfetch

Creatomate MCP server & CLI

Edit templates, check renders for free and make videos and images, from Claude, Codex or Cursor.

VideoCreatomate

Dub MCP server & CLI

Create short links, read clicks and sales, and run your partner program, from Claude, Codex or Cursor.

SalesDub

fal.ai MCP server & CLI

Find models, check prices, and generate images and videos, from Claude, Codex or Cursor.

Videofal.ai

Flodesk MCP server & CLI

Manage subscribers, segments and workflows, and draft campaigns, from Claude, Codex or Cursor.

SalesFlodesk

Fluent WordPress MCP server & CLI

Work with FluentCRM, FluentCommunity and Fluent Forms on your WordPress site, from Claude, Codex or Cursor.

SalesWordPress

Senja MCP server & CLI

Find, approve and tag testimonials, send invites and export them, from Claude, Codex or Cursor.

SalesSenja

Testimonial.to MCP server & CLI

Read, import and export your testimonials, and send request emails, from Claude, Codex or Cursor.

SalesTestimonial.to

Lemon Squeezy MCP server & CLI

Read and refund orders, manage subscriptions and check license keys, from Claude, Codex or Cursor.

SalesLemon Squeezy

Gumroad MCP server & CLI

Read sales and payouts, refund orders and manage products and license keys, from Claude, Codex or Cursor.

SalesGumroad

Fourthwall MCP server & CLI

Manage products and orders, ship them, and run promotions and giveaways, from Claude, Codex or Cursor.

SalesFourthwall

Teachable MCP server & CLI

Read your courses and student progress, and manage enrollments from Claude, Codex or Cursor.

SalesTeachable

Related free tools

All free tools

Creator finder

The creators and founders worth following, by topic and platform, each with everything about them in 1 place.

Social mediaAny website

Engagement rate calculator

Any account's engagement rate by followers and by views, from a username or a link, against benchmarks for its size.

Social mediainstagramInstagramtiktokTikTok

Social media post analyzer

Paste a link to a post on any of 7 platforms and see how it did against the account's typical post, and why.

Social mediaxXlinkedinLinkedIn

TikTok money calculator

What your views earn in the Creator Rewards Program at your own RPM, plus brand deals.

Social mediaAny website

Instagram money calculator

What gifts, subscriptions and brand deals earn you on Instagram, after app store fees.

Social mediaAny website

X character counter

Counts the way X counts: links as 23, emoji as 2. LinkedIn, Instagram, TikTok, Threads and YouTube limits too.

WritingblueskyBlueskyinstagramInstagram

LinkedIn character counter

LinkedIn's 3,000-character post limit, counted as you type, with X, Threads and Bluesky beside it.

WritinglinkedinLinkedIn

Threads character counter

Threads' 500-character limit, counted as you type, with X, Bluesky and LinkedIn beside it.

WritingthreadsThreads

Bluesky character counter

Bluesky's 300-character limit, counted the way the protocol counts, with X and Threads beside it.

WritingblueskyBluesky

Mastodon character counter

Mastodon's 500-character default, counted the way Mastodon counts links and mentions.

WritingmastodonMastodon

Instagram character counter

Instagram's 2,200-character caption limit, counted as you type, with TikTok and the rest beside it.

WritinginstagramInstagram

TikTok character counter

TikTok's 2,200 caption limit, counted the way TikTok counts it, with emoji as 2.

WritingtiktokTikTok

Navid Moazzez

AI business strategist

Navid Moazzez helps creators and founders master AI and build their own AI Operating System (AI OS) to automate their business and life.

Navid.me is reader-supported. When you buy through links on this site, I may earn an affiliate commission. Read the affiliate disclaimer.

Free AI newsletter

The most actionable AI newsletter for founders

Every week, get proven AI strategies, curated tools, and step-by-step systems to grow your audience, create better content, and build a profitable creator business.

No fluff, no filler, no BS. Just five minutes each week that might level up your online business and life.

P.S. Sign up now to get free access to my ultimate AI tools guide for creators.

Loved by 10,000+ readers
Loved by 10,000+ readers