You're in Claude Desktop, Claude Code, or Cursor and you want to pull 20 local
businesses from Google Maps, check Trustpilot reviews for a competitor, or find
breakout YouTube videos — without leaving your assistant or writing scraping code.
Apify publishes a Model Context Protocol (MCP) server at https://mcp.apify.com.
Connect it once and your assistant can search the Apify Store and run its
web-scraping Actors directly from a prompt.
Step 1: Create a free Apify account
Go to apify.com and sign up with
Google, GitHub, or email. No credit card needed for the free plan.
Step 2: Copy your Apify API token
In Apify Console, open Settings → API & Integrations
(console.apify.com/settings/integrations) and copy the Personal API token.
Treat it like a password.
Step 3: Add the MCP server to your assistant
Claude Desktop
Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or
%APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"apify": {
"command": "npx",
"args": ["-y", "@apify/actors-mcp-server"],
"env": {
"APIFY_TOKEN": "your-token-here"
}
}
}
}
Restart Claude Desktop.
Claude Code
claude mcp add apify -e APIFY_TOKEN=your-token-here -- npx -y @apify/actors-mcp-server
Cursor
Open Settings → Features → MCP Servers and add:
{
"apify": {
"command": "npx",
"args": ["-y", "@apify/actors-mcp-server"],
"env": {
"APIFY_TOKEN": "your-token-here"
}
}
}
Meta Muse
Open a new Muse chat and paste:
Create a custom connector for Apify's MCP server at https://mcp.apify.com.
It authenticates with my Apify API token, sent as a bearer token in the
Authorization header. Ask me for the token in a secure prompt.
When Muse asks for the token, paste it into the secure prompt — not the chat.
Step 4: Verify the connection
Using the Apify connector, fetch the details of the Actor
automatic/google-maps-places-scraper and show its title and pricing.
Don't run it.
It's working if you see the Actor's title and its price per result.
Step 5: Run your first Actor
Local businesses from Google Maps (~$0.03)
Use the Apify connector to run the Actor
automatic/google-maps-places-scraper with searchQueries ["coffee shop"],
location "London, ON", countryCode "ca" and maxPlaces 20.
If the run hasn't finished when the call returns, check its status until
it has, then fetch the dataset items. Give me a table of name, rating,
reviews, phone and website, best rated first.
Competitor Facebook/Instagram ads (~$0.04 for 25 ads)
Use the Apify connector to run the Actor
automatic/facebook-ads-library-scraper with searchTerms ["meal kit"],
country "US", activeStatus "active" and maxItems 25.
If the run hasn't finished when the call returns, check its status until
it has, then fetch the dataset items. Tell me which advertisers have
the most ads and what offers they're making.
Trustpilot complaints for any company (~$0.03)
Use the Apify connector to run the Actor
automatic/trustpilot-reviews-scraper with companies ["chewy.com"],
maxReviewsPerCompany 50 and stars ["1", "2"].
If the run hasn't finished when the call returns, check its status until
it has, then fetch the dataset items. List the five most common complaints
with a count and one quote each.
Troubleshooting
| Symptom | Fix |
|---|---|
| "No Apify connector" | Re-run setup step and restart the assistant |
| Run starts but no results | Add "check its status until finished, then fetch the dataset items" |
| Token rejected | No spaces before or after the token |
| Run charged but empty | The search term returned no results; the Actor reports this |
Good to know
- Each Actor run is billed on completion. Approve when your assistant asks.
- The free plan's $5/month covers ~150–200 small runs. See Apify pricing for paid plans.
- Pricing is per row of output on most Actors. Check the Actor's page for today's rate.
The original setup guide (with Muse-specific screenshots) is at
https://ssh.autos/guides/muse-apify.html.
Affiliate disclosure: links to apify.com in this post carry
?fpr=automatic. If you sign up for a paid Apify plan, ssh.autos may earn a commission at no cost to you.
Originally published at https://ssh.autos
Top comments (1)
Connecting a scraping tool to several agent clients is only the first integration step. The durable boundary is a small, typed tool surface with explicit URL scope, rate limits, cost visibility, and output-size caps—otherwise the client differences become the least surprising source of failure.