Atlas Data: Ads, Jobs & Trends

Atlas Data MCP 工具

面向 AI Agent 的广告库、就业市场和搜索趋势数据，通过托管的 Apify MCP 服务以 MCP 工具的形式提供。

无需安装或托管任何内容。此仓库包含可直接粘贴的客户端配置，以及 Atlas Data 工具套件的 MCP Registry 元数据（server.json）。

MCP 工具名称	返回内容	Store 页面	示例
atlasdata--google-trends-scraper-reliable	Google Trends 随时间变化的关注度、各地区关注度、相关查询和主题	Apify Store	仓库
atlasdata--google-ads-transparency-scraper-reliable	按域名或广告主查询 Google Ads Transparency Center 广告：格式、首次/最后展示时间、地区、欧盟展示次数范围、创意素材	Apify Store	仓库
atlasdata--linkedin-ad-library-scraper-reliable	按公司、关键词或付款方查询 LinkedIn Ad Library 广告：文本、创意素材、CTA、落地页 URL、展示次数和定向信息	Apify Store	仓库
atlasdata--tiktok-ad-library-scraper-reliable	按关键词、广告主或广告 ID 查询 TikTok Ad Library 广告：视频、文本、触达人数、落地页、可选的定向详情	Apify Store	仓库
atlasdata--google-jobs-scraper-reliable	按查询条件和地点获取 Google Jobs 职位信息：解析后的薪资、工作类型、描述、申请链接	Apify Store	仓库

Apify MCP 服务还提供通用辅助工具（get-actor-run、get-dataset-items、get-key-value-store-record、abort-actor-run），方便 Agent 分页获取大量结果。

端点

https://mcp.apify.com/?tools=atlasdata/google-trends-scraper-reliable,atlasdata/google-ads-transparency-scraper-reliable,atlasdata/linkedin-ad-library-scraper-reliable,atlasdata/tiktok-ad-library-scraper-reliable,atlasdata/google-jobs-scraper-reliable

• 传输方式：可流式传输的 HTTP
• 身份验证：Apify OAuth（支持远程 OAuth 的客户端会打开登录窗口），或通过 Authorization: Bearer <token> 发送 Apify API 令牌。可在 console.apify.com/settings/integrations 获取令牌。
• 计费：每个工具都是按结果付费的 Apify Actor，费用计入你自己的 Apify 账户。当前价格请查看各 Store 页面。
• 想减少工具数量？从 tools= 列表中移除条目。每个条目的格式为 atlasdata/<actor-name>。

Cursor

添加到 ~/.cursor/mcp.json（全局）或 .cursor/mcp.json（项目）。使用 OAuth 时，只需填写 URL（configs/cursor-mcp.json）：

{
  "mcpServers": {
    "atlas-data": {
      "url": "https://mcp.apify.com/?tools=atlasdata/google-trends-scraper-reliable,atlasdata/google-ads-transparency-scraper-reliable,atlasdata/linkedin-ad-library-scraper-reliable,atlasdata/tiktok-ad-library-scraper-reliable,atlasdata/google-jobs-scraper-reliable"
    }
  }
}

若要使用令牌而非 OAuth，请添加请求头，并将令牌保存在环境变量中（configs/cursor-mcp-token.json）：

{
  "mcpServers": {
    "atlas-data": {
      "url": "https://mcp.apify.com/?tools=atlasdata/google-trends-scraper-reliable,atlasdata/google-ads-transparency-scraper-reliable,atlasdata/linkedin-ad-library-scraper-reliable,atlasdata/tiktok-ad-library-scraper-reliable,atlasdata/google-jobs-scraper-reliable",
      "headers": {
        "Authorization": "Bearer ${env:APIFY_TOKEN}"
      }
    }
  }
}

Claude Desktop

选项 A：自定义连接器（OAuth）。 在 Claude Desktop 中打开 Settings → Connectors → Add custom connector，将其命名为 Atlas Data，然后粘贴上面的端点 URL。出现提示时，登录 Apify。

选项 B：使用令牌的配置文件。 编辑 claude_desktop_config.json（Settings → Developer → Edit Config）。此方式使用 mcp-remote 桥接远程服务，因此必须安装 Node.js 18+（configs/claude_desktop_config.json）：

{
  "mcpServers": {
    "atlas-data": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.apify.com/?tools=atlasdata/google-trends-scraper-reliable,atlasdata/google-ads-transparency-scraper-reliable,atlasdata/linkedin-ad-library-scraper-reliable,atlasdata/tiktok-ad-library-scraper-reliable,atlasdata/google-jobs-scraper-reliable",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer <your-apify-token>"
      }
    }
  }
}

之后重启 Claude Desktop。（请求头通过环境变量传递，因为某些客户端会错误处理 args 中的空格。）

Claude Code

claude mcp add --transport http atlas-data \
  "https://mcp.apify.com/?tools=atlasdata/google-trends-scraper-reliable,atlasdata/google-ads-transparency-scraper-reliable,atlasdata/linkedin-ad-library-scraper-reliable,atlasdata/tiktok-ad-library-scraper-reliable,atlasdata/google-jobs-scraper-reliable" \
  --header "Authorization: Bearer $APIFY_TOKEN"

VS Code（GitHub Copilot Agent 模式）

.vscode/mcp.json，并在首次使用时提示输入令牌（configs/vscode-mcp.json）：

{
  "inputs": [
    { "type": "promptString", "id": "apify-token", "description": "Apify API token", "password": true }
  ],
  "servers": {
    "atlas-data": {
      "type": "http",
      "url": "https://mcp.apify.com/?tools=atlasdata/google-trends-scraper-reliable,atlasdata/google-ads-transparency-scraper-reliable,atlasdata/linkedin-ad-library-scraper-reliable,atlasdata/tiktok-ad-library-scraper-reliable,atlasdata/google-jobs-scraper-reliable",
      "headers": { "Authorization": "Bearer ${input:apify-token}" }
    }
  }
}

示例提示词

• “比较过去 12 个月美国对 notion、obsidian 和 logseq 的 Google Trends 关注度，并列出相关的上升趋势查询。”
• “自 9 月以来，hubspot.com 在德国投放了哪些 Google 广告？按格式分组。”
• “获取 HubSpot 过去 30 天的 LinkedIn 广告，并总结主要行动号召。”
• “查找法国提及 protein bar 的有效 TikTok 视频广告，并列出其落地页。”
• “获取本周在柏林发布的 50 个 data engineer 职位，并提供列出的薪资范围。”

工具输入遵循每个 Actor 的输入架构。Agent 通过 MCP 查看架构；Store 页面和示例代码仓库会记录每个字段。

费用控制

每次运行都会按结果向进行身份验证的 Apify 账户收费。测试时，请将 maxAdsPerSearch 和 maxResults 等限制设小；如果 Agent 会在无人值守的情况下运行，请在 Apify Console 中设置每月使用量上限。

在代码中调用相同的工具

这些工具都是常规的 Apify Actor，因此无需 MCP 也能获取相同数据：

from apify_client import ApifyClient

client = ApifyClient("<APIFY_TOKEN>")  # pip install apify-client
run = client.actor("atlasdata/google-jobs-scraper-reliable").call(
    run_input={"queries": ["data engineer"], "location": "Austin, TX", "country": "us", "maxResults": 20}
)
for job in client.dataset(run.default_dataset_id).iterate_items():
    print(job["title"], "|", job["companyName"], "|", job.get("salary"))

更多示例（Python、Node.js、curl）见上方链接的各工具代码仓库。

注册表元数据

server.json 将这套工具描述为官方 MCP 注册表 中的 io.github.AtlasDataDenmark/atlas-data。它通过 GitHub OIDC，由 发布工作流 发布。

支持

请在此代码仓库或对应工具的代码仓库中提交问题。

许可证

此代码仓库中的配置和文档采用 MIT 许可证。工具本身是托管在 Apify 上的服务。