apify-marketing-agency-database

用途

本技能用于从 Clutch.co 目录批量构建营销机构数据库，避免手动逐页翻查。输入一个 Clutch 分类或地区页面 URL，即可输出每个机构一行干净的结构化 JSON 数据，可直接用于电子表格、CRM 或向量存储。

适用场景包括：需要一份数字营销机构（或网站开发者、任意 Clutch 分类）的结构化列表，并按服务或城市筛选；为线索列表、市场地图或目录产品填充真实机构及其公开费率；获取整个分类的去重结果，而非仅第一屏。

不适用场景：获取已知特定公司的完整深度档案。若需指定公司的完整企业信息、服务组合、价格区间和评价，应使用配套的 apify-company-data-api 技能（同一 Actor 的 profiles 模式）。

主要能力

每个列出的机构对应一行数据集记录。result_type 字段区分列表行与错误行。列表字段包括：

name、slug、profile_url
website（公司网站 URL，可能保留跟踪参数）
rating、review_count、is_verified、verification（徽章列表）
min_project_size、hourly_rate、employees、location
service_lines（名称加百分比，卡片显示时提供；JSON 中为嵌套列表，导出 CSV 时需显式序列化）
source_url（该行来源的目录页面）、fetched_at

如需对某行深入，可将其 profile_url 传入 apify-company-data-api 技能获取完整档案与评价。

使用方式

前置条件：Apify 账户；通过 apify login 认证，或设置 APIFY_TOKEN 环境变量。

Actor 信息：

商店页面：https://apify.com/johnvc/clutch-agency-api?fpr=9n7kx3&fp_sid=awesomeskills
Actor ID：johnvc/clutch-agency-api
计费：按事件付费，无启动费。

使用 Apify CLI 运行。数字营销机构第一页，上限 50 行：

apify actors call "johnvc/clutch-agency-api" -i '{"mode":"directory","directoryUrls":["https://clutch.co/agencies/digital-marketing"],"maxPagesPerDirectory":1,"maxItems":50}' \
  --json \
  --user-agent apify-awesome-skills/apify-marketing-agency-database \
  2>/dev/null

按地区筛选的分类，深入三页（使用已编码筛选条件的 Clutch URL）：

apify actors call "johnvc/clutch-agency-api" -i '{"mode":"directory","directoryUrls":["https://clutch.co/us/agencies/digital-marketing"],"maxPagesPerDirectory":3,"maxItems":200}' \
  --json \
  --user-agent apify-awesome-skills/apify-marketing-agency-database \
  2>/dev/null

大规模抓取前确认实时 schema 与价格：

apify actors info "johnvc/clutch-agency-api" --input \
  --user-agent apify-awesome-skills/apify-marketing-agency-database \
  2>/dev/null

apify actors info "johnvc/clutch-agency-api" --json \
  --user-agent apify-awesome-skills/apify-marketing-agency-database \
  2>/dev/null

从完成的运行中读回数据行：

apify datasets get-items <DATASET_ID> --format json \
  --user-agent apify-awesome-skills/apify-marketing-agency-database \
  2>/dev/null

除裸输入 schema 获取外，每次调用都带三个标志：--json（或 --format json）、--user-agent apify-awesome-skills/apify-marketing-agency-database、2>/dev/null。

从 Claude 或其他 AI 智能体（MCP）运行：该 Actor 支持 MCP。添加托管服务器 URL：

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

然后可提问，例如：“帮我从 Clutch 构建一个数字营销机构表格，包含评分、时薪、团队规模和网站。”MCP 设置文档：https://docs.apify.com/platform/integrations/mcp

工作流程

选择已编码目标细分市场的 Clutch 目录 URL。Clutch 为大多数服务与地区组合提供页面，例如 https://clutch.co/agencies/digital-marketing 或 https://clutch.co/us/web-developers。
先用 maxPagesPerDirectory:1 和较小的 maxItems 开始，查看行结构和分类，再决定是否付费深度抓取。
提高 maxPagesPerDirectory 以深入。每页是独立请求，这是主要成本杠杆；maxItems 是硬上限。
通过选择更具体的 Clutch URL 进行筛选，之后在数据集上按 rating、min_project_size 或 location 过滤。
赞助和推荐卡片会在页面间重复。Actor 在整个运行中按 profile URL 去重，同一机构不会重复计费。
将行视为机构前先检查 result_type。错误行带有 error_message 和 error_type。
如需丰富候选列表，将 profile_url 值传入 apify-company-data-api 技能获取完整记录与评价。

输入参数

mode（枚举 directory、profiles、search）：本工作流使用 directory。
directoryUrls（数组）：任意 Clutch 分类或地区页面，裸路径也可。
maxPagesPerDirectory（整数，最小 1）：每个目录 URL 的结果页数。每页约 70 至 90 家公司。
maxItems（整数）：本次运行的硬交付上限，可用作支出上限，限制输出行数。

每个列表字段都带有说明：需要更大批量？联系我们可为你的账户提高限制。

成本

按事件付费，无启动费，因此无返回结果的运行几乎不产生费用。请用上述 info 命令确认实时价格，不要信任此处复制的数字。

listing-scraped 事件每交付一行机构触发一次；估算时需计入每行存储的 apify-default-dataset-item 费用。出现在多个页面的公司（赞助和推荐卡片重复）会被去重并只计费一次。maxItems 限制运行，maxPagesPerDirectory 限制在此之前抓取的页数。

列表定价为引流性质，因此整个分类成本较低。建议确认阈值：估算低于约 5 美元时提及，超过约 5 美元时警告用户，超过约 20 美元时获取明确确认。成本表述为“大约 X 美元”，绝不作为保证。

限制

目录行是卡片数据：名称、评分、费率、规模、位置、网站和服务组合。如需描述、成立年份、完整服务百分比、按服务定价和评价，请用 company-data 工作流丰富 profile_url。
目录页可能返回超过 50 家公司，因为 Clutch 在自然列表中混入赞助和推荐卡片。全部返回，跨页去重。
仅公开目录数据。不含登录后的邮箱，不含私密联系数据。
返回的网站 URL 可能保留跟踪查询参数；作为干净链接展示前请检查。

故障排除

零行且无错误行：URL 不是有效的 Clutch 目录（如 profile URL 或非 Clutch 主机），已被规范化移除。请粘贴分类页面 URL。
深度运行时行数少于预期：后续页面无返回是分页结束，不是失败。
某行字段稀疏：该卡片在 Clutch 上信息较少；丰富其 profile_url 获取完整记录。
跨运行重复：在下游按 profile_url 或 slug 去重，绝不要按 name。

更多成本护栏与错误恢复见 references/gotchas.md，Actor 路由表见 references/actor-index.md。

技能介绍

用途