{
  "markdown": "# Clutch.co Agency API: B2B Company Data, Directory & Reviews\n\nA company data API for [Clutch.co](https://clutch.co), the B2B directory of\nagencies and service providers. Walk any category directory, pull full company\nprofiles, and paginate every verified client review, returned as JSON and as\nLLM-ready markdown. This repo shows two ways to use it: a Python quick start, and\nModel Context Protocol (MCP) install steps for Claude, Cursor, and ChatGPT.\n\nActor on Apify Store: [Clutch.co Agency API](https://apify.com/johnvc/clutch-agency-api?fpr=9n7kx3)\n\nGet a free Apify API key: https://apify.com?fpr=9n7kx3\n\n[![Watch the walkthrough](https://img.youtube.com/vi/jREWahDGhJM/hqdefault.jpg)](https://www.youtube.com/watch?v=jREWahDGhJM)\n\n## Text walkthrough\n\nThis is a **company data API** for Clutch.co. Pick a `mode`, give it a URL or a\nkeyword, and it returns clean rows. In `directory` mode you pass a Clutch\ncategory page such as `https://clutch.co/web-developers` and get one row per\ncompany: name, rating, review count, minimum project size, hourly rate, team\nsize, location, and the profile link, which is how you build a marketing agency\ndatabase or a list of digital marketing agencies for a location. In `profiles`\nmode you pass company profile URLs (or bare slugs) and get the full record:\ndescription, founding year, service mix with percentages, industries, client\nsizes, pricing bands, and every verified client review as its own row. Every\nprofile can also carry Clutch's own LLM-ready markdown at no extra cost, which\nmakes this a good source for shortlisting B2B service providers or feeding a RAG\npipeline. In `search` mode you pass a keyword and it collects the matching\ncompany profiles for you.\n\n## What you get\n\n- **Directory listings** (`listing` rows): name, rating, review count,\n  verification badges, minimum project size, hourly rate, employees, location,\n  profile URL.\n- **Company profiles** (`profile` rows): everything above plus description,\n  founding year, all office locations, languages, service lines, focus areas,\n  industries, client-size split, cost rating, pricing by service, and packages.\n- **Client reviews** (`review` rows): title, rating, the quality, schedule,\n  cost, and willing-to-refer breakdown, project services, budget, duration,\n  reviewer role and industry, and Clutch's own summaries.\n- **Markdown** on any profile row (default), and raw **HTML** on request.\n\n## Quick start (Python)\n\nThis example uses Python with [uv](https://docs.astral.sh/uv/). It never uses\npip.\n\n1. Install uv (if you do not have it):\n\n```bash\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n```\n\n2. Clone this repo and enter it:\n\n```bash\ngit clone https://github.com/johnisanerd/Apify-Clutch-Agency-API.git\ncd Apify-Clutch-Agency-API\n```\n\n3. Add your Apify API token. Copy `.env.example` to `.env` and paste your token\n   (get one free at https://apify.com?fpr=9n7kx3):\n\n```bash\ncp .env.example .env\n```\n\n4. Run it. The default run stays cheap (one directory page, 10 rows):\n\n```bash\nuv run python clutch-agency-api-example.py\n```\n\n5. Try the other modes:\n\n```bash\nuv run python clutch-agency-api-example.py --example directory\nuv run python clutch-agency-api-example.py --example profiles\nuv run python clutch-agency-api-example.py --example search\n```\n\n## Input parameters\n\n| Field | Type | Notes |\n|---|---|---|\n| `mode` | string | `directory` (default), `profiles`, or `search`. |\n| `directoryUrls` | array | Clutch category or location pages, e.g. `https://clutch.co/web-developers`. |\n| `maxPagesPerDirectory` | integer | Result pages per directory URL. Each page is about 70-90 companies. |\n| `profileUrls` | array | Company profile URLs, e.g. `https://clutch.co/profile/ignite-visibility`. A bare slug works. |\n| `searchQueries` | array | Free-text queries, e.g. `shopify development`. |\n| `includeReviews` | boolean | Return every verified review as its own row. Default `true`. |\n| `maxReviewsPerProfile` | integer | Cap on reviews per company. |\n| `outputFormats` | array | `json`, `markdown` (default), and optionally `html`. |\n| `maxItems` | integer | Hard ceiling on rows for the run. Use it as a spend cap. |\n\n## Example output\n\n```json\n{\n  \"result_type\": \"profile\",\n  \"name\": \"Ignite Visibility\",\n  \"profile_url\": \"https://clutch.co/profile/ignite-visibility\",\n  \"website\": \"https://ignitevisibility.com\",\n  \"rating\": 4.8,\n  \"review_count\": 175,\n  \"min_project_size\": \"$1,000+\",\n  \"hourly_rate\": \"$100 - $149\",\n  \"employees\": \"250 - 999\",\n  \"founded_year\": 2013,\n  \"headquarters\": \"San Diego, CA\",\n  \"service_lines\": [{ \"name\": \"Search Engine Optimization\", \"percent\": 30 }],\n  \"markdown\": \"# Ignite Visibility\\n## Company Information\\n...\"\n}\n```\n\n## Install as an MCP tool\n\nThe sections below add the Clutch.co Agency API to Claude, Cursor, and ChatGPT\nas a Model Context Protocol tool, so an assistant can call it directly. The MCP\nserver URL is the same everywhere:\n\n```\nhttps://mcp.apify.com/?tools=actors,docs,johnvc/clutch-agency-api\n```\n\nGet a free Apify account at https://apify.com?fpr=9n7kx3 and a token at\nhttps://console.apify.com/settings/integrations .\n\n### Install in Claude Cowork Desktop\n\n![Install in Claude Cowork Desktop](https://raw.githubusercontent.com/johnisanerd/ApifyPublicData/main/assets/guides/install_mcp_into_claude_desktop.png)\n\nCowork is the desktop app's automation mode. To give it the Clutch.co Agency API\nas a tool, add the Apify MCP server as a connector.\n\n1. Open the Claude desktop app and go to **Settings → Connectors** (or\n   **Settings → Developer → Edit Config** to edit `claude_desktop_config.json`\n   directly).\n   - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`\n   - Windows: `%APPDATA%\\Claude\\claude_desktop_config.json`\n2. Add the Apify MCP server, preloaded with only this Actor:\n\n```json\n{\n  \"mcpServers\": {\n    \"apify\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"mcp-remote\",\n        \"https://mcp.apify.com/?tools=actors,docs,johnvc/clutch-agency-api\"\n      ]\n    }\n  }\n}\n```\n\n3. Restart the app. When Cowork first calls the tool, complete the OAuth prompt\n   in your browser, or add your Apify API token in the connector settings to\n   skip OAuth.\n4. In a Cowork chat, ask it to run the Clutch.co Agency API.\n\nDownload the desktop app and start a free trial: https://claude.ai/referral/uIlpa7nPLg\nMore help: https://docs.apify.com/platform/integrations/claude-desktop\n\n### Install in Claude Code\n\n![Install in Claude Code](https://raw.githubusercontent.com/johnisanerd/ApifyPublicData/main/assets/guides/install_mcp_into_claude_code.png)\n\nClaude Code is the command-line tool. Add the Actor's MCP server with one\ncommand:\n\n```bash\nclaude mcp add --transport http apify \\\n  \"https://mcp.apify.com/?tools=actors,docs,johnvc/clutch-agency-api\"\n```\n\nTo use a token instead of browser OAuth:\n\n```bash\nclaude mcp add --transport http apify \\\n  \"https://mcp.apify.com/?tools=actors,docs,johnvc/clutch-agency-api\" \\\n  --header \"Authorization: Bearer YOUR_APIFY_TOKEN\"\n```\n\nThen verify with `claude mcp list`, or run `/mcp` inside a session. Ask Claude\nCode to call the Clutch.co Agency API.\n\nTry Claude Code free: https://claude.ai/referral/uIlpa7nPLg\nClaude Code MCP docs: https://code.claude.com/docs/en/mcp\n\n### Install in Claude (website)\n\n![Install in Claude (website)](https://raw.githubusercontent.com/johnisanerd/ApifyPublicData/main/assets/guides/install_mcp_into_claude_ai.png)\n\nOn claude.ai you add Apify as a connector, then enable just this Actor's tool.\n\n1. Go to **Settings → Connectors → Browse connectors** and search for\n   **Apify MCP server**. Install it (enable or update if prompted).\n2. When connecting, authenticate with your Apify API token, and enable the tool\n   `johnvc/clutch-agency-api`.\n3. In any chat, open **+ → Connectors** and turn on **Apify**.\n4. Alternatively, choose **Add custom connector** and paste the full MCP URL\n   `https://mcp.apify.com/?tools=actors,docs,johnvc/clutch-agency-api`, using\n   OAuth when prompted.\n5. Ask Claude to run the Clutch.co Agency API.\n\nOpen Claude on the web: https://claude.ai\n\n### Install in Cursor\n\n![Install in Cursor](https://raw.githubusercontent.com/johnisanerd/ApifyPublicData/main/assets/guides/install_mcp_into_cursor.png)\n\nCursor reads MCP servers from a project file at `.cursor/mcp.json`.\n\n1. In your project, create `.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"apify\": {\n      \"url\": \"https://mcp.apify.com/?tools=actors,docs,johnvc/clutch-agency-api\"\n    }\n  }\n}\n```\n\n2. If you prefer token auth over browser OAuth, add a header:\n\n```json\n{\n  \"mcpServers\": {\n    \"apify\": {\n      \"url\": \"https://mcp.apify.com/?tools=actors,docs,johnvc/clutch-agency-api\",\n      \"headers\": { \"Authorization\": \"Bearer YOUR_APIFY_TOKEN\" }\n    }\n  }\n}\n```\n\n3. Open **Cursor → Settings → MCP** and confirm the **apify** server is\n   connected (green dot).\n4. In Composer or Chat, ask Cursor to call the Clutch.co Agency API.\n\nNew to Cursor? Get it here: https://cursor.com/referral?code=XQP4VBLI3NNX\n\n### Install in ChatGPT\n\n![Install in ChatGPT](https://raw.githubusercontent.com/johnisanerd/ApifyPublicData/main/assets/guides/install_mcp_into_ChatGPT.png)\n\nChatGPT connects to the Apify MCP server through Developer mode (available on\nChatGPT Pro, Plus, Business, Enterprise, and Education plans).\n\n1. Click your profile icon, then go to **Settings > Apps**. If you do not see a\n   **Create app** button, open **Advanced settings** and enable\n   **Developer mode**.\n2. Click **Create app** and fill out the form:\n   - **Name:** Apify\n   - **MCP Server URL:** `https://mcp.apify.com/?tools=actors,docs,johnvc/clutch-agency-api`\n   - **Authentication:** OAuth\n3. Click **Create** and authorize the connection with Apify.\n4. To use the app in a conversation, click **+** in the chat, choose\n   **Developer mode**, and select **Apify**.\n\nMore help: https://docs.apify.com/platform/integrations/mcp\n\n## People also search for\n\n**Is this a company data API?**\nYes. It returns structured company records from Clutch.co: firmographics, service\nmix, pricing bands, ratings, and verified reviews, as JSON you can drop into a\nCRM or a vector store.\n\n**Can I use it as a B2B directory?**\nYes. Directory mode reads any Clutch category or location page and returns one\nrow per listed company, which is a ready-made B2B directory export.\n\n**Can I build a marketing agency database?**\nYes. Point directory mode at a marketing category, page through the results, and\nyou get a marketing agency database with ratings, rates, and locations.\n\n**Does it get client reviews?**\nYes. In profiles and search modes, every verified client review comes back as\nits own row, paginated until the company's declared total is reached.\n\n**Do I need a Clutch.co account or API key?**\nNo. There is nothing to configure on Clutch's side. You only need an Apify API\ntoken to run the Actor. Get one free at https://apify.com?fpr=9n7kx3 .\n\n## Links\n\n- Actor on Apify Store: https://apify.com/johnvc/clutch-agency-api?fpr=9n7kx3\n- Apify Python client docs: https://docs.apify.com/api/client/python/\n- Apify MCP docs: https://docs.apify.com/platform/integrations/mcp\n\nLast Updated: 2026.09.03\n",
  "bytes": 11173,
  "sha": "b527f77ff1af6ed9484a374d73f6c0521a6cc282f669ae32a37c42ad5e094bc5",
  "repo_slug": "johnisanerd/apify-clutch-agency-api",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_johnisanerd_clutch_agency_api_8335d0cc/readme"
}