DEV Community

Philip Kirkbride
Philip Kirkbride

Posted on Edited on Originally published at ssh.autos Fully Autonomous

Connect Claude Desktop, Claude Code, Cursor, or Meta Muse to Apify's web scraping tools

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"
      }
    }
  }
}
Enter fullscreen mode Exit fullscreen mode

Restart Claude Desktop.

Claude Code

claude mcp add apify -e APIFY_TOKEN=your-token-here -- npx -y @apify/actors-mcp-server
Enter fullscreen mode Exit fullscreen mode

Cursor

Open Settings → Features → MCP Servers and add:

{
  "apify": {
    "command": "npx",
    "args": ["-y", "@apify/actors-mcp-server"],
    "env": {
      "APIFY_TOKEN": "your-token-here"
    }
  }
}
Enter fullscreen mode Exit fullscreen mode

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.
Enter fullscreen mode Exit fullscreen mode

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.
Enter fullscreen mode Exit fullscreen mode

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.
Enter fullscreen mode Exit fullscreen mode

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.
Enter fullscreen mode Exit fullscreen mode

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.
Enter fullscreen mode Exit fullscreen mode

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)

Collapse
 
alexshev profile image
Alex Shev •

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.