# How to integrate ScrapeCreators MCP with Atomic Agent

```json
{
  "title": "How to integrate ScrapeCreators MCP with Atomic Agent",
  "toolkit": "ScrapeCreators",
  "toolkit_slug": "scrapecreators",
  "framework": "Atomic Agent",
  "framework_slug": "atomic-agent",
  "url": "https://composio.dev/toolkits/scrapecreators/framework/atomic-agent",
  "markdown_url": "https://composio.dev/toolkits/scrapecreators/framework/atomic-agent.md",
  "updated_at": "2026-09-11T05:38:14.783Z"
}
```

## Introduction

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,500+ apps through Composio, including ScrapeCreators.
This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a ScrapeCreators account. See the [Atomic Agent documentation](https://atomicagent.io/docs/?cta_placement=atomic-agent-docs) for installation instructions.

## Also integrate ScrapeCreators with

- [ChatGPT](https://composio.dev/toolkits/scrapecreators/framework/chatgpt)
- [Claude Cowork](https://composio.dev/toolkits/scrapecreators/framework/claude-cowork)
- [Hermes](https://composio.dev/toolkits/scrapecreators/framework/hermes-agent)

## TL;DR

### How Atomic Agent connects to ScrapeCreators
Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.
Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

## Connect ScrapeCreators to Atomic Agent

### Connect ScrapeCreators to Atomic Agent
- Sign up or sign in to the [Composio dashboard](https://dashboard.composio.dev/?cta_placement=atomic-agent-api-key). Copy your API key.
- In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
- Ask Atomic Agent to do something in ScrapeCreators. It searches Composio for the right tool.
- On first use, open the sign-in link returned in the chat. Connect your ScrapeCreators account, then return to Atomic Agent to continue.
### Headless setup
Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

```bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY
```

## What is the ScrapeCreators MCP server, and what's possible with it?

The ScrapeCreators MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your ScrapeCreators account. It provides structured and secure access so your agent can perform ScrapeCreators operations on your behalf.

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `SCRAPECREATORS_FIND_CREATOR_SOCIAL_PROFILES` | Find Creator Social Profiles | Discover and verify a creator's linked profiles across supported social platforms from one source handle. A live lookup costs 10 credits; use cache_max_age when stale results are acceptable. |
| `SCRAPECREATORS_GET_CREDIT_BALANCE` | Get Credit Balance | Return the connected ScrapeCreators account's remaining prepaid credit balance without consuming credits. |
| `SCRAPECREATORS_GET_FACEBOOK_AD` | Get Facebook Ad | Return creative, advertiser, platform, delivery, spend, reach, and active-period details for one Meta Ad Library ad. A live scrape costs 1 credit; an eligible cache hit costs 0 credits. |
| `SCRAPECREATORS_GET_FACEBOOK_POST` | Get Facebook Post | Return content, author, media, engagement, and the feedback ID for one public Facebook post or reel. A live scrape costs 1 credit; an eligible cache hit costs 0 credits. |
| `SCRAPECREATORS_GET_FACEBOOK_PROFILE` | Get Facebook Profile | Return public identity, audience, contact, business, and Ad Library metadata for one Facebook profile or Page. A live scrape costs 1 credit; an eligible cache hit costs 0 credits. |
| `SCRAPECREATORS_GET_GITHUB_REPOSITORY` | Get GitHub Repository | Return public metadata, ownership, popularity, language, topics, license, and activity for one GitHub repository. This lookup costs 1 credit. |
| `SCRAPECREATORS_GET_GITHUB_USER` | Get GitHub User | Return public identity, biography, organization, location, social links, and repository and follower counts for one GitHub user. This lookup costs 1 credit. |
| `SCRAPECREATORS_GET_GITHUB_USER_CONTRIBUTIONS` | Get GitHub User Contributions | Return a GitHub user's public contribution graph for one year, including the annual total and daily counts and intensity levels. This lookup costs 1 credit. |
| `SCRAPECREATORS_GET_GOOGLE_AD` | Get Google Ad | Return creative variations, advertiser, format, regions, impression estimates, and display dates for one Google Ads Transparency ad. Text fields are extracted with OCR and may contain inaccuracies. A live scrape costs 1 credit; an eligible cache hit costs 0 credits. |
| `SCRAPECREATORS_GET_INSTAGRAM_MEDIA_TRANSCRIPT` | Get Instagram Media Transcript | Transcribe speech from an Instagram video or reel under two minutes, returning one transcript per video slide when applicable. A live transcription costs 1 credit; an eligible cache hit costs 0 credits. |
| `SCRAPECREATORS_GET_INSTAGRAM_POST` | Get Instagram Post | Return detailed metadata and engagement for one Instagram post or reel. A live scrape costs 1 credit; an eligible cache hit costs 0 credits. |
| `SCRAPECREATORS_GET_INSTAGRAM_PROFILE` | Get Instagram Profile | Return public identity, biography, verification, links, and account statistics for one Instagram profile; this does not return the post feed. A live scrape costs 1 credit, while an eligible cache hit costs 0 credits. |
| `SCRAPECREATORS_GET_LINKEDIN_AD` | Get LinkedIn Ad | Return advertiser, creative, destination, targeting, impressions, and run dates for one public LinkedIn ad. Date and impression data may be null when LinkedIn does not expose them. This request costs 1 credit. |
| `SCRAPECREATORS_GET_LINKEDIN_COMPANY` | Get LinkedIn Company | Return public company identity, industry, workforce, funding, headquarters, specialties, and website data from LinkedIn. The lookup costs 1 credit. |
| `SCRAPECREATORS_GET_LINKEDIN_POST` | Get LinkedIn Post | Return content, author, publication date, engagement, and embedded comments for one public LinkedIn post or article. The lookup costs 1 credit. |
| `SCRAPECREATORS_GET_LINKEDIN_PROFILE` | Get LinkedIn Profile | Return public professional identity, experience, education, activity, and audience data for one LinkedIn person profile. The lookup costs 1 credit. |
| `SCRAPECREATORS_GET_REDDIT_POST` | Get Reddit Post | Return content, author, community, score, flags, media URL, and comment count for one public Reddit post. This lookup costs 1 credit. |
| `SCRAPECREATORS_GET_REDDIT_SUBREDDIT` | Get Reddit Subreddit | Return public metadata, rules, audience size, and activity statistics for one subreddit. A live lookup costs 1 credit; an eligible cache hit costs 0 credits. |
| `SCRAPECREATORS_GET_THREADS_POST` | Get Threads Post | Return content, author, media, engagement, comments, and related context for one public Threads post. A live scrape costs 1 credit, while an eligible cache hit costs 0 credits. |
| `SCRAPECREATORS_GET_THREADS_PROFILE` | Get Threads Profile | Return public identity, biography, links, verification, privacy, and follower data for one Threads profile. A live scrape costs 1 credit, while an eligible cache hit costs 0 credits. |
| `SCRAPECREATORS_GET_TIKTOK_AD` | Get TikTok Ad | Return creative, advertiser, objective, landing-page, performance, audience, and video details for one TikTok ad. The lookup costs 1 credit. |
| `SCRAPECREATORS_GET_TIKTOK_PROFILE` | Get TikTok Profile | Return public identity, bio, verification, and account statistics for one TikTok creator; this does not return the creator's video feed. A live scrape costs 1 credit; an eligible cache hit costs 0 credits. |
| `SCRAPECREATORS_GET_TIKTOK_VIDEO` | Get TikTok Video | Return metadata, engagement, author, music, and media URLs for one TikTok video. A live scrape costs 1 credit; an eligible cache hit costs 0 credits. |
| `SCRAPECREATORS_GET_TIKTOK_VIDEO_TRANSCRIPT` | Get TikTok Video Transcript | Extract a timestamped WEBVTT transcript from a TikTok video under two minutes. A native-caption lookup costs 1 credit; optional AI fallback adds 10 credits. |
| `SCRAPECREATORS_GET_TWITTER_PROFILE` | Get Twitter Profile | Return public identity, biography, verification, audience, business, and subscription metadata for one X/Twitter account. A live scrape costs 1 credit; an eligible cache hit costs 0 credits. |
| `SCRAPECREATORS_GET_TWITTER_TWEET` | Get Twitter Tweet | Return content, author, media, views, and engagement for one public X/Twitter post. A live scrape costs 1 credit; an eligible cache hit costs 0 credits. |
| `SCRAPECREATORS_GET_TWITTER_TWEET_TRANSCRIPT` | Get Twitter Tweet Transcript | Return the available transcript for a video under two minutes attached to one public X/Twitter post. Longer videos are unsupported. A live lookup costs 1 credit; an eligible cache hit costs 0 credits. |
| `SCRAPECREATORS_GET_YOUTUBE_CHANNEL` | Get YouTube Channel | Return public profile, subscriber and view statistics, tags, country, and linked accounts for one YouTube channel. A live scrape costs 1 credit; an eligible cache hit costs 0 credits. |
| `SCRAPECREATORS_GET_YOUTUBE_VIDEO` | Get YouTube Video | Return metadata, engagement, chapters, creator, paid-promotion status, and caption-track availability for one YouTube video or Short. A live scrape costs 1 credit; an eligible cache hit costs 0 credits. |
| `SCRAPECREATORS_GET_YOUTUBE_VIDEO_TRANSCRIPT` | Get YouTube Video Transcript | Return timestamped and plain-text public captions for a YouTube video or Short, including long videos when captions exist. A live lookup costs 1 credit; an eligible cache hit costs 0 credits. |
| `SCRAPECREATORS_LIST_FACEBOOK_COMPANY_ADS` | List Facebook Company Ads | Return one page of Meta Ad Library ads for a company or Page with delivery, status, media, language, date, and sort filters. Each page costs 1 credit. |
| `SCRAPECREATORS_LIST_FACEBOOK_POST_COMMENTS` | List Facebook Post Comments | Return one page of comments on a Facebook post or reel, accepting its URL or the faster feedback ID. Each page costs 1 credit. |
| `SCRAPECREATORS_LIST_FACEBOOK_PROFILE_POSTS` | List Facebook Profile Posts | Return one page of up to three public posts from a Facebook profile or Page with a cursor for the next page. Each page costs 1 credit. |
| `SCRAPECREATORS_LIST_GITHUB_TRENDING_REPOSITORIES` | List GitHub Trending Repositories | Return GitHub's current trending repositories filtered by programming language, period, and optional spoken language. This request costs 1 credit. |
| `SCRAPECREATORS_LIST_GITHUB_USER_ACTIVITY` | List GitHub User Activity | Return one month page of a GitHub user's public contribution activity for a selected year. Pages move backward by month, and each page costs 1 credit. |
| `SCRAPECREATORS_LIST_GITHUB_USER_PULL_REQUESTS` | List GitHub User Pull Requests | Return one page of a GitHub user's public pull requests, sorted newest first, with optional creation-date filters and a cursor for the next page. Each page costs 1 credit. |
| `SCRAPECREATORS_LIST_GITHUB_USER_REPOSITORIES` | List GitHub User Repositories | Return one page of repositories associated with a GitHub user, filtered by ownership and sort order, with a cursor for the next page. Each page costs 1 credit. |
| `SCRAPECREATORS_LIST_GOOGLE_COMPANY_ADS` | List Google Company Ads | Return one page of Google Ads Transparency creatives for a company. The default get_ad_details=false request costs 1 credit. Setting get_ad_details=true costs exactly 25 credits per request and must be explicitly requested. |
| `SCRAPECREATORS_LIST_INSTAGRAM_POST_COMMENTS` | List Instagram Post Comments | Return one page of comments on an Instagram post or reel. Reply expansion defaults to false. Enabling it always costs 15 credits even if no replies are found, is much slower, and may time out near 29 seconds. |
| `SCRAPECREATORS_LIST_INSTAGRAM_USER_POSTS` | List Instagram User Posts | Return one page of a public Instagram user's posts, reels, photos, videos, and carousels with a cursor for the next page. Each page costs 1 credit. |
| `SCRAPECREATORS_LIST_LINKEDIN_COMPANY_POSTS` | List LinkedIn Company Posts | Return one numeric page of public posts from a LinkedIn company Page. LinkedIn limits this endpoint to pages 1 through 7, each costing 1 credit; the provider returns no next-page metadata. |
| `SCRAPECREATORS_LIST_REDDIT_POST_COMMENTS` | List Reddit Post Comments | Return one page of public comments or replies for a Reddit post. The tool queues every independent continuation branch while sending only one provider cursor per request. Each page costs 1 credit. |
| `SCRAPECREATORS_LIST_REDDIT_SUBREDDIT_POSTS` | List Reddit Subreddit Posts | Return one page of posts from a subreddit with sort and timeframe controls and an opaque cursor for the next page. A live page costs 1 credit; a cache hit costs 0 credits. |
| `SCRAPECREATORS_LIST_THREADS_USER_POSTS` | List Threads User Posts | Return the currently public recent posts for one Threads profile in a single response. Threads exposes only about the latest 20 to 30 posts and this endpoint provides no pagination. Each request costs 1 credit. |
| `SCRAPECREATORS_LIST_TIKTOK_PROFILE_VIDEOS` | List TikTok Profile Videos | Return one page of a TikTok creator's posted videos, sorted by latest or popularity, with a cursor for the next page. Each page costs 1 credit. |
| `SCRAPECREATORS_LIST_TWITTER_USER_TWEETS` | List Twitter User Tweets | Return the public tweets currently exposed for one X/Twitter account in a single response. X/Twitter typically exposes roughly 100 popular tweets, not a chronological or complete history. The request costs 1 credit. |
| `SCRAPECREATORS_LIST_YOUTUBE_CHANNEL_VIDEOS` | List YouTube Channel Videos | Return one page of videos uploaded by a YouTube channel, sorted by latest or popularity, with an opaque cursor for the next page. Each page costs 1 credit. |
| `SCRAPECREATORS_SEARCH_FACEBOOK_AD_LIBRARY` | Search Facebook Ad Library | Search Meta's public Ad Library by keyword with country, language, status, media, date, and political-ad filters, returning one page and an opaque cursor. Each page costs 1 credit. |
| `SCRAPECREATORS_SEARCH_GOOGLE_ADVERTISERS` | Search Google Advertisers | Search Google Ads Transparency advertisers by name or keyword in one country. Returns advertiser IDs and associated domains for subsequent company-ad searches. Each search costs 1 credit. |
| `SCRAPECREATORS_SEARCH_LINKEDIN_ADS` | Search LinkedIn Ads | Search LinkedIn's public Ad Library by company, company ID, or keyword with country and date filters, returning one page and an opaque cursor. Each page costs 1 credit. |
| `SCRAPECREATORS_SEARCH_LINKEDIN_POSTS` | Search LinkedIn Posts | Search Google-indexed public LinkedIn posts by keyword and optional recency, returning one page and a bounded continuation cursor. Results are best-effort rather than a complete LinkedIn-native index. Each page costs 1 credit. |
| `SCRAPECREATORS_SEARCH_REDDIT` | Search Reddit | Search Reddit posts or comments by keyword with type, sort, and timeframe filters, returning one page and a continuation cursor. Each page costs 1 credit. |
| `SCRAPECREATORS_SEARCH_THREADS_POSTS` | Search Threads Posts | Search public Threads posts by keyword and optional inclusive date range, returning the provider's single, non-pageable result set. The provider may return more than 10 posts. Each request costs 1 credit. |
| `SCRAPECREATORS_SEARCH_TIKTOK_AD_LIBRARY` | Search TikTok Ad Library | Search TikTok's public ad library by general query or advertiser name, returning one page and an opaque cursor. Each page costs 1 credit. |
| `SCRAPECREATORS_SEARCH_YOUTUBE` | Search YouTube | Search YouTube for videos, Shorts, channels, or playlists with date, popularity, duration, and region filters, returning one page and a continuation cursor. Each page costs 1 credit. |

## Supported Triggers

None listed.

## Troubleshooting

### Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

### Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

### Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See [Composio pricing](/pricing) for the current limits that apply to your connection.

## Complete Code

None listed.

## Conclusion

### Use ScrapeCreators from Atomic Agent
With your account connected, ask Atomic Agent to work with ScrapeCreators in natural language. You can connect more apps through the same Composio integration as you need them.
Visit the [Atomic Agent website](https://atomicagent.io/?cta_placement=atomic-agent-site) or inspect the [Atomic Agent source code](https://github.com/AtomicBot-ai/atomic-agent?cta_placement=atomic-agent-repo).

## How to build ScrapeCreators MCP Agent with another framework

- [ChatGPT](https://composio.dev/toolkits/scrapecreators/framework/chatgpt)
- [Claude Cowork](https://composio.dev/toolkits/scrapecreators/framework/claude-cowork)
- [Hermes](https://composio.dev/toolkits/scrapecreators/framework/hermes-agent)

## Related Toolkits

- [Reddit](https://composio.dev/toolkits/reddit) - Reddit is a social news platform with thriving user-driven communities (subreddits). It's the go-to place for discussion, content sharing, and viral marketing.
- [Facebook](https://composio.dev/toolkits/facebook) - Facebook is a social media and advertising platform for businesses and creators. It helps you connect, share, and manage content across your public Facebook Pages.
- [Linkedin](https://composio.dev/toolkits/linkedin) - LinkedIn is a professional networking platform for connecting, sharing content, and engaging with business opportunities. It's the go-to place for building your professional brand and unlocking new career connections.
- [Active campaign](https://composio.dev/toolkits/active_campaign) - ActiveCampaign is a marketing automation and CRM platform for managing email campaigns, sales pipelines, and customer segmentation. It helps businesses engage customers and drive growth through smart automation and targeted outreach.
- [ActiveTrail](https://composio.dev/toolkits/active_trail) - ActiveTrail is a user-friendly email marketing and automation platform. It helps you reach subscribers and automate campaigns with ease.
- [Adobe Marketing Agent MCP](https://composio.dev/toolkits/adobe_marketing_agent_mcp) - Adobe Marketing Agent MCP is Adobe's hosted MCP service that exposes marketing context, preferences, and agent capabilities. Use it to provide agents with campaign, audience, and analytics context via a managed integration.
- [Ahrefs](https://composio.dev/toolkits/ahrefs) - Ahrefs is an SEO and marketing platform for site audits, keyword research, and competitor insights. It helps you improve search rankings and drive organic traffic.
- [AimTell](https://composio.dev/toolkits/aimtell) - AimTell is a web push notification platform for managing websites, subscribers, campaigns, segments, and delivery analytics. Use it to send targeted browser notifications and measure engagement across your web push campaigns.
- [Amcards](https://composio.dev/toolkits/amcards) - AMCards lets you create and mail personalized greeting cards online. Build stronger customer relationships with easy, automated card campaigns.
- [Beamer](https://composio.dev/toolkits/beamer) - Beamer is a news and changelog platform for in-app announcements and feature updates. It helps companies boost user engagement by sharing news where users are most active.
- [Beehiiv](https://composio.dev/toolkits/beehiiv) - Beehiiv is a newsletter platform for creating and managing publications and subscribers. It helps grow audience engagement and monetize your mailing list.
- [Benchmark email](https://composio.dev/toolkits/benchmark_email) - Benchmark Email is a platform for creating, sending, and tracking email campaigns. It's built to help you engage audiences and analyze results—all in one place.
- [Bigmailer](https://composio.dev/toolkits/bigmailer) - BigMailer is an email marketing platform for managing multiple brands with white-labeling and automation. It helps teams streamline campaigns and simplify integration with Amazon SES.
- [Bitly](https://composio.dev/toolkits/bitly) - Bitly is a link management platform for shortening, customizing, sharing, and tracking links and QR codes. It helps teams create branded links and measure engagement across campaigns.
- [BlueFox Email](https://composio.dev/toolkits/bluefox_email) - BlueFox Email is an email API for managing contacts, subscriber lists, and sending transactional and triggered messages. Use it to reliably send transactional and triggered emails and manage subscribers at scale.
- [Brandfetch](https://composio.dev/toolkits/brandfetch) - Brandfetch is an API that delivers company logos, colors, and visual branding assets. It helps marketers and developers keep brand visuals consistent everywhere.
- [Braze](https://composio.dev/toolkits/braze) - Braze is a customer engagement platform for managing user data, messaging, campaigns, and analytics. Use it to deliver targeted, multi-channel messaging and analyze campaign performance.
- [Brevo](https://composio.dev/toolkits/brevo) - Brevo is an all-in-one email and SMS marketing platform for transactional messaging, automation, and CRM. It helps businesses engage customers and streamline communications through powerful campaign tools.
- [Buffer](https://composio.dev/toolkits/buffer) - Buffer is a social media management platform for planning, creating, scheduling, and publishing posts across connected channels. It helps teams keep content organized and publish consistently without jumping between social apps.
- [BulkPublish](https://composio.dev/toolkits/bulkpublish) - BulkPublish is a social media publishing platform for managing scheduled content across multiple channels. It helps teams plan campaigns, publish consistently, and track performance in one place.

## Frequently Asked Questions

### What are the differences in Tool Router MCP and ScrapeCreators MCP?

With a standalone ScrapeCreators MCP server, the agents and LLMs can only access a fixed set of ScrapeCreators tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from ScrapeCreators and many other apps based on the task at hand, all through a single MCP endpoint.

### Can I use Tool Router MCP with Atomic Agent?

Yes, you can. Atomic Agent fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right ScrapeCreators tools.

### Can I manage the permissions and scopes for ScrapeCreators while using Tool Router?

Yes, absolutely. You can configure which ScrapeCreators scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

### How safe is my data with Composio Tool Router?

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your ScrapeCreators data and credentials are handled as safely as possible.

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)