clutch-agency-api

Clutch.co Agency API：B2B 公司数据、目录与评价

这是一个适用于 Clutch.co 的公司数据 API。Clutch.co 是 B2B 代理机构和服务提供商目录。浏览任意类别目录，提取完整公司资料，并分页获取每条经过验证的客户评价；返回格式为 JSON 和适用于大模型的 Markdown。本仓库展示了两种使用方式：Python 快速入门，以及 Claude、Cursor 和 ChatGPT 的 Model Context Protocol (MCP) 安装步骤。

Apify Store 上的 Actor：Clutch.co Agency API

免费获取 Apify API 密钥：https://apify.com?fpr=9n7kx3

文字说明

这是一个适用于 Clutch.co 的公司数据 API。选择一个 mode，提供 URL 或关键词，它就会返回整洁的数据行。在 directory 模式下，传入 Clutch 类别页面，例如 https://clutch.co/web-developers，即可获得每家公司一行的数据：名称、评分、评价数量、最低项目规模、小时费率、团队规模、所在地和资料链接。你可以借此建立营销代理机构数据库，或按地区整理数字营销代理机构列表。在 profiles 模式下，传入公司资料 URL（或不带路径的 slug），即可获取完整记录：简介、成立年份、服务组合及占比、行业、客户规模、定价范围，以及每条经过验证的客户评价（各自作为单独一行）。每份资料还可以附带 Clutch 自带的、适用于大模型的 Markdown，无需额外付费，因此它非常适合用于筛选 B2B 服务提供商或为 RAG 流水线提供数据。在 search 模式下，传入关键词，它就会为你收集匹配的公司资料。

可以获取的内容

• 目录列表（listing 行）：名称、评分、评价数量、验证徽章、最低项目规模、小时费率、员工人数、所在地、资料 URL。
• 公司资料（profile 行）：包含上述全部信息，另加简介、成立年份、所有办公地点、语言、服务类别、重点领域、行业、客户规模细分、费用评级、各服务的定价和套餐。
• 客户评价（review 行）：标题、评分、质量、进度、成本和推荐意愿细分、项目服务、预算、时长、评价者的职位和行业，以及 Clutch 自带的摘要。
• 任何资料行都包含 Markdown（默认），也可按需获取原始 HTML。

快速入门（Python）

本示例使用 Python 和 uv。不会使用 pip。

1. 安装 uv（如果尚未安装）：

curl -LsSf https://astral.sh/uv/install.sh | sh

2. 克隆此仓库并进入其中：

git clone https://github.com/johnisanerd/Apify-Clutch-Agency-API.git
cd Apify-Clutch-Agency-API

3. 添加你的 Apify API 令牌。将 .env.example 复制为 .env，并粘贴你的令牌 （可在此免费获取：https://apify.com?fpr=9n7kx3）：

cp .env.example .env

4. 运行程序。默认运行成本较低（一个目录页面，10 行数据）：

uv run python clutch-agency-api-example.py

5. 试试其他模式：

uv run python clutch-agency-api-example.py --example directory
uv run python clutch-agency-api-example.py --example profiles
uv run python clutch-agency-api-example.py --example search

输入参数

字段	类型	说明
mode	字符串	directory（默认）、profiles 或 search。
directoryUrls	数组	Clutch 类别或地区页面，例如 https://clutch.co/web-developers。
maxPagesPerDirectory	整数	每个目录 URL 的结果页数。每页约有 70-90 家公司。
profileUrls	数组	公司资料 URL，例如 https://clutch.co/profile/ignite-visibility。也可使用不带路径的 slug。
searchQueries	数组	自由文本查询，例如 shopify development。
includeReviews	布尔值	将每条经过验证的评价作为单独一行返回。默认值为 true。
maxReviewsPerProfile	整数	每家公司评价数量上限。
outputFormats	数组	json、markdown（默认），以及可选的 html。
maxItems	整数	本次运行的行数硬性上限。可将其用作费用上限。

示例输出

{
  "result_type": "profile",
  "name": "Ignite Visibility",
  "profile_url": "https://clutch.co/profile/ignite-visibility",
  "website": "https://ignitevisibility.com",
  "rating": 4.8,
  "review_count": 175,
  "min_project_size": "$1,000+",
  "hourly_rate": "$100 - $149",
  "employees": "250 - 999",
  "founded_year": 2013,
  "headquarters": "San Diego, CA",
  "service_lines": [{ "name": "Search Engine Optimization", "percent": 30 }],
  "markdown": "# Ignite Visibility\n## Company Information\n..."
}

安装为 MCP 工具

以下各节介绍如何将 Clutch.co Agency API 添加到 Claude、Cursor 和 ChatGPT 中，作为 Model Context Protocol 工具，让助手可以直接调用。MCP 服务 URL 在所有平台上都相同：

https://mcp.apify.com/?tools=actors,docs,johnvc/clutch-agency-api

在 https://apify.com?fpr=9n7kx3 注册免费 Apify 账户，并在 https://console.apify.com/settings/integrations 获取令牌。

在 Claude Cowork Desktop 中安装

Cowork 是桌面应用的自动化模式。若要将 Clutch.co Agency API 作为工具提供给它，请添加 Apify MCP 服务作为连接器。

1. 打开 Claude 桌面应用，前往 Settings → Connectors（或 前往 Settings → Developer → Edit Config，直接编辑 claude_desktop_config.json）。
   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json
2. 添加 Apify MCP 服务，并且只预加载此 Actor：

{
  "mcpServers": {
    "apify": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.apify.com/?tools=actors,docs,johnvc/clutch-agency-api"
      ]
    }
  }
}

3. 重启应用。Cowork 首次调用此工具时，请在浏览器中完成 OAuth 提示， 或在连接器设置中添加 Apify API 令牌以跳过 OAuth。
4. 在 Cowork 聊天中，让它运行 Clutch.co Agency API。

下载桌面应用并开始免费试用：https://claude.ai/referral/uIlpa7nPLg 更多帮助：https://docs.apify.com/platform/integrations/claude-desktop

在 Claude Code 中安装

Claude Code 是命令行工具。使用一条命令添加 Actor 的 MCP 服务：

claude mcp add --transport http apify \
  "https://mcp.apify.com/?tools=actors,docs,johnvc/clutch-agency-api"

若要使用令牌而非浏览器 OAuth：

claude mcp add --transport http apify \
  "https://mcp.apify.com/?tools=actors,docs,johnvc/clutch-agency-api" \
  --header "Authorization: Bearer YOUR_APIFY_TOKEN"

然后使用 claude mcp list 验证，或在会话中运行 /mcp。让 Claude Code 调用 Clutch.co Agency API。

免费试用 Claude Code：https://claude.ai/referral/uIlpa7nPLg Claude Code MCP 文档：https://code.claude.com/docs/en/mcp

在 Claude（网站）中安装

在 claude.ai 上，先将 Apify 添加为连接器，然后仅启用此 Actor 的工具。

1. 前往 Settings → Connectors → Browse connectors，搜索 Apify MCP server。安装它（如出现提示，请启用或更新）。
2. 连接时，使用 Apify API 令牌进行身份验证，并启用工具 johnvc/clutch-agency-api。
3. 在任意聊天中，打开 + → Connectors 并开启 Apify。
4. 或者，选择 Add custom connector 并粘贴完整的 MCP URL https://mcp.apify.com/?tools=actors,docs,johnvc/clutch-agency-api，并在出现提示时 使用 OAuth。
5. 让 Claude 运行 Clutch.co Agency API。

在网页上打开 Claude：https://claude.ai

在 Cursor 中安装

Cursor 从项目文件 .cursor/mcp.json 中读取 MCP 服务。

1. 在项目中创建 .cursor/mcp.json：

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com/?tools=actors,docs,johnvc/clutch-agency-api"
    }
  }
}

2. 如果希望使用令牌身份验证而非浏览器 OAuth，请添加一个标头：

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com/?tools=actors,docs,johnvc/clutch-agency-api",
      "headers": { "Authorization": "Bearer YOUR_APIFY_TOKEN" }
    }
  }
}

3. 打开 Cursor → Settings → MCP，确认 apify 服务已连接 （显示绿色圆点）。
4. 在 Composer 或 Chat 中，让 Cursor 调用 Clutch.co Agency API。

刚开始使用 Cursor？在这里获取：https://cursor.com/referral?code=XQP4VBLI3NNX

在 ChatGPT 中安装

ChatGPT 通过开发者模式连接到 Apify MCP 服务（适用于 ChatGPT Pro、Plus、Business、Enterprise 和 Education 计划）。

1. 点击个人资料图标，然后前往 Settings > Apps。如果看不到 Create app 按钮，请打开 Advanced settings 并启用 Developer mode。
2. 点击 Create app 并填写表单：
   • Name： Apify
   • MCP Server URL： https://mcp.apify.com/?tools=actors,docs,johnvc/clutch-agency-api
   • Authentication： OAuth
3. 点击 Create，并通过 Apify 授权连接。
4. 要在对话中使用此应用，请点击聊天中的 +，选择 Developer mode，然后选择 Apify。

更多帮助：https://docs.apify.com/platform/integrations/mcp

🤖 向 AI 助手询问此 Actor

在你选择的 AI 中打开一条关于 Clutch.co Agency API 的即发提示词：

• 💬 ChatGPT
• 🧠 Claude
• 🔍 Perplexity
• 🅒 Copilot

人们还会搜索

这是公司数据 API 吗？ 是。它会以 JSON 格式返回 Clutch.co 的结构化公司记录，包括公司概况、服务组合、价格区间、评分和经验证的评价，可直接导入 CRM 或向量存储。

我可以把它用作 B2B 目录吗？ 可以。目录模式会读取任意 Clutch 类别或位置页面，并为每家列出的公司返回一行，可直接导出为 B2B 目录。

我可以构建营销机构数据库吗？ 可以。将目录模式指向营销类别，翻阅结果页面，即可获得包含评分、费率和位置的营销机构数据库。

它会获取客户评价吗？ 会。在资料和搜索模式下，每条经验证的客户评价都会作为独立行返回，并分页获取，直至达到公司声明的总数。

我需要 Clutch.co 账户或 API 密钥吗？ 不需要。无需在 Clutch 端进行任何配置。运行 Actor 只需要 Apify API 令牌。可在 https://apify.com?fpr=9n7kx3 免费获取。

链接

• Apify Store 上的 Actor：https://apify.com/johnvc/clutch-agency-api?fpr=9n7kx3
• Apify Python 客户端文档：https://docs.apify.com/api/client/python/
• Apify MCP 文档：https://docs.apify.com/platform/integrations/mcp

最后更新：2026.10.27