DataForSEO 集成实战指南：在 AI Agent 中实现 SERP、关键词研究与外链分析

AI 技能人工智能【免费下载链接】marketingskillsMarketing skills for Claude Code and AI agents. CRO, copywriting, SEO, analytics, and growth engineering.项目地址https://gitcode.com/GitHub_Trending/mar/marketingskills点击查看免费下载DataForSEO 是本仓库中面向 SEO 场景的核心数据 API 集成为 Claude Code 等 AI Agent 提供 SERP 结果、关键词研究、外链分析与 On-Page 审计能力。通过本文你将掌握 DataForSEO 的认证方式、Live/Task 双模式调用模式、仓库内置 CLI 工具 dataforseo.js 的完整用法以及如何在 seo-audit、programmatic-seo、competitor-profiling 等技能中把它接入实际的 SEO 工作流。概览DataForSEO 是什么能做什么DataForSEO 是一个综合性的 SEO 数据 API覆盖搜索引擎结果页SERP、关键词数据、外链数据、On-Page 分析与 DataForSEO Labs 实验性接口。仓库对其定位是「Comprehensive SEO data API for SERP results, keyword research, backlinks, and on-page analysis」完整说明见 tools/integrations/dataforseo.md。其能力矩阵如下IntegrationAvailableNotesAPI✓SERP、Keywords Data、Backlinks、On-Page、LabsMCP-暂未提供 MCP 服务CLI✓dataforseo.jsSDK✓Python、TypeScript、PHP、Java、C#在仓库的 工具注册表 中DataForSEO 被归入 SEO 分类定位是「SERP tracking, backlinks, on-page audits」适合需要程序化、大批量获取搜索引擎数据的场景与 Semrush竞争分析、Ahrefs外链研究等工具形成互补。认证Basic Auth 与凭据管理DataForSEO 使用 HTTP Basic Auth这是集成的第一步也是最容易出错的地方认证类型Basic Auth请求头Authorization: Basic {base64(login:password)}凭据获取登录 DataForSEO 后台的 API Access 标签页https://app.dataforseo.com/api-access注意事项API 密码是系统自动生成的与账户登录密码不同二者不可混用在仓库的 CLI 工具 中凭据通过环境变量注入而非硬编码const LOGIN process.env.DATAFORSEO_LOGIN const PASSWORD process.env.DATAFORSEO_PASSWORD // ... const AUTH Basic Buffer.from(${LOGIN}:${PASSWORD}).toString(base64)依据 tools/clis/README.md 的约定对应的环境变量名为DATAFORSEO_LOGIN与DATAFORSEO_PASSWORD。仓库对凭据管理的硬性要求是永远不要把 API Key 硬编码进脚本应存放在 shell profile~/.zshrc、~/.bashrc或.env文件中后者已被 gitignore。在 CLI 中配置认证export DATAFORSEO_LOGINyour-login export DATAFORSEO_PASSWORDyour-api-password如果缺少这两个环境变量CLI 会直接报错退出并提示所需变量见 dataforseo.js。API 调用模式Live 与 Task-based 双模式DataForSEO 的绝大多数接口都提供两种调用方式这是理解其 API 架构的关键Live同步请求路径含/live结果在同一响应中返回适合少量、即时查询Task-based异步先POST /task_post提交任务再通过GET /task_get/{$id}轮询获取结果适合大批量请求另一个重要约定是请求体永远是 JSON 数组即使只有一条请求也是如此。这一点在 dataforseo.js 的实现中体现得淋漓尽致——所有 POST 调用都包裹在[ {...} ]数组中。使用内置 CLI零依赖的单文件工具仓库为 DataForSEO 提供了零依赖的 Node.js CLINode 18无需npm install文件位于 tools/clis/dataforseo.js。所有 CLI 遵循统一的命令模式{tool} resource action [options]。安装与调用方式三种方式任选其一详见 tools/clis/README.md# 方式一直接运行 node tools/clis/dataforseo.js serp google --keyword marketing automation # 方式二软链接到全局路径 ln -sf $(pwd)/tools/clis/dataforseo.js ~/.local/bin/dataforseo dataforseo serp google --keyword marketing automation # 方式三把整个目录加入 PATH export PATH$PATH:/path/to/marketingskills/tools/clisCLI 支持的资源与子命令CLI 内部通过cmdsub两级分发见 dataforseo.js支持以下命令树资源子命令必需参数对应 API 端点serpgoogle--keyword/serp/google/organic/live/regularserplocations无GET /serp/google/locationsserplanguages无GET /serp/google/languageskeywordsvolume--keywords逗号分隔/keywords_data/google_ads/search_volume/livekeywordsfor-site--target域名/keywords_data/google_ads/keywords_for_site/livekeywordsfor-keywords--keywords/keywords_data/google_ads/keywords_for_keywords/livekeywordstrends--keywords/keywords_data/google_trends/explore/livebacklinkssummary--target/backlinks/summary/livebacklinkslist--target/backlinks/backlinks/livebacklinksrefdomains--target/backlinks/referring_domains/livebacklinksanchors--target/backlinks/anchors/livebacklinksindex无GET /backlinks/indexonpageaudit--url/on_page/instant_pageslabscompetitors--target/dataforseo_labs/google/competitors_domain/livelabsranked-keywords--target/dataforseo_labs/google/ranked_keywords/livelabsdomain-intersection--targets至少 2 个域名/dataforseo_labs/google/domain_intersection/live常用可选参数包括--location-code code地区代码默认2840美国--language-code code语言代码默认en--location name地区名称默认United States--language name语言名称默认English--limit n返回条数默认100--no-jsOn-Page 审计时禁用 JavaScript 渲染默认启用--dry-run预览请求而不实际发送凭据会以***掩码显示这些默认值在 dataforseo.js 中统一解析。--dry-run是仓库所有 CLI 的通用安全特性用于在不消耗 API 配额的前提下检查请求构造是否正确。输出与管道化CLI 以 JSON 格式输出到 stdout方便与jq或脚本组合tools/clis/README.md# 查询某域名的外链列表并提取来源 URL node tools/clis/dataforseo.js backlinks list --target example.com | jq .tasks[0].result[].url_from # 查询一批关键词的搜索量保存到文件 node tools/clis/dataforseo.js keywords volume --keywords email marketing,marketing automation volumes.json # 对比两个域名的关键词交集 node tools/clis/dataforseo.js labs domain-intersection --targets your-site.com,competitor.com核心 API 操作详解以下操作直接继承自 tools/integrations/dataforseo.md 的原始示例并补充了 CLI 等价用法。SERP — Google 自然结果LivePOST https://api.dataforseo.com/v3/serp/google/organic/live/regular [{ keyword: marketing automation, location_name: United States, language_name: English }]CLI 等价命令node tools/clis/dataforseo.js serp google --keyword marketing automation可用于程序化排名追踪定时对目标关键词批量发起 SERP 查询记录各域名的出现位置与变化趋势。关键词数据 — 搜索量LivePOST https://api.dataforseo.com/v3/keywords_data/google_ads/search_volume/live [{ keywords: [email marketing, marketing automation, crm software], location_code: 2840, language_code: en }]CLI 等价命令关键词用逗号分隔node tools/clis/dataforseo.js keywords volume --keywords email marketing,marketing automation,crm software --location-code 2840 --language-code en关键词数据 — 站点关键词Live根据目标域名反向发现其相关关键词是竞争对手关键词策略分析的利器POST https://api.dataforseo.com/v3/keywords_data/google_ads/keywords_for_site/live [{ target: example.com, location_code: 2840, language_code: en }]CLI 等价命令node tools/clis/dataforseo.js keywords for-site --target example.com外链 — 摘要SummaryPOST https://api.dataforseo.com/v3/backlinks/summary/live [{ target: example.com, internal_list_limit: 10, backlinks_status_type: live }]CLI 等价命令node tools/clis/dataforseo.js backlinks summary --target example.com外链 — 明细列表ListPOST https://api.dataforseo.com/v3/backlinks/backlinks/live [{ target: example.com, mode: as_is, limit: 100, backlinks_status_type: live }]CLI 等价命令mode默认as_islimit默认 100node tools/clis/dataforseo.js backlinks list --target example.com --limit 100外链 — 引用域名Referring domainsPOST https://api.dataforseo.com/v3/backlinks/referring_domains/live [{ target: example.com, limit: 100 }]CLI 等价命令node tools/clis/dataforseo.js backlinks refdomains --target example.com外链 — 索引统计数据库规模GET https://api.dataforseo.com/v3/backlinks/indexCLI 等价命令node tools/clis/dataforseo.js backlinks index该接口返回 DataForSEO 外链数据库的全局统计可用于评估数据新鲜度与覆盖面。On-Page — 即时页面审计Instant pages auditPOST https://api.dataforseo.com/v3/on_page/instant_pages [{ url: https://example.com/page, enable_javascript: true }]CLI 等价命令默认启用 JavaScript 渲染--no-js可关闭node tools/clis/dataforseo.js onpage audit --url https://example.com/pageSERP — 地区与语言列表GET https://api.dataforseo.com/v3/serp/google/locations GET https://api.dataforseo.com/v3/serp/google/languagesCLI 等价命令node tools/clis/dataforseo.js serp locations node tools/clis/dataforseo.js serp languages这两个接口用于在发起正式查询前确认location_code与language_code的合法取值避免无效参数导致请求失败。DataForSEO Labs — 竞争情报CLI 独有扩展CLI 额外封装了 Labs 系列的三个竞争分析接口这是原集成文档之外、由仓库源码补充的能力# 找出与目标域名关键词重叠最紧密的有机竞争者 node tools/clis/dataforseo.js labs competitors --target example.com # 获取目标域名当前排名的关键词及位置 node tools/clis/dataforseo.js labs ranked-keywords --target example.com # 找出两个域名共同排名的关键词直接竞争关系 node tools/clis/dataforseo.js labs domain-intersection --targets your-site.com,competitor.com其中domain-intersection的实现值得注意CLI 会将多个目标域名动态构造成target1、target2……的键见 dataforseo.js因此至少需要传入两个域名。关键指标字段正确解读返回数据是落地分析的前提。文档明确了两组核心指标关键词指标search_volume— 月搜索量competition— 竞争程度0-1 区间cpc— 单次点击成本monthly_searches— 按月拆分的搜索量数组外链指标total_backlinks— 外链总数referring_domains— 唯一引用域名数domain_rank— 域名权威度评分backlinks_spam_score— 垃圾评分这些字段在 competitor-profiling 的 MCP 工具参考 中被进一步细化为领域级情报dataforseo_labs_google_domain_rank_overview返回organic_count关键词数、organic_traffic预估月流量、organic_cost流量价值美元估算ranked_keywords返回每个关键词的keyword、position、search_volume与排名的url。限流与配额DataForSEO 在响应头中携带限流信息是程序化调用必须监控的信号限流响应头X-RateLimit-Limit、X-RateLimit-Remaining外链 API每分钟 2000 次请求最多 30 个并发其他端点按具体接口与套餐而定在 competitor-profiling 的 MCP 工具参考 中也有对应的错误处理建议遇到限流时「错开请求时间优先拉取高价值数据」。在仓库技能中的实际应用DataForSEO 在本仓库不是孤立工具它被多个技能作为数据源引用形成完整的 SEO 工作流。competitor-profiling竞品情报流水线在 competitor-profiling 技能 中DataForSEO Labs 与 Backlinks 接口是构建竞争对手画像的核心数据层backlinks_summary— 获取域名权威度、外链总数、引用域名数、垃圾评分backlinks_referring_domains— 分析顶级引用域名与链接获取模式dataforseo_labs_google_ranked_keywords— 统计排名的有机关键词总数、Top 3 / Top 10 / Top 100 关键词分布、预估流量dataforseo_labs_google_domain_rank_overview— 域名级有机指标与流量价值dataforseo_labs_google_keywords_for_site— 发现对方布局的关键词与内容空白dataforseo_labs_google_competitors_domain— 找出对方最紧密的有机竞争者可能发现你未考虑过的对手dataforseo_labs_google_relevant_pages— 定位对方流量最高的页面工具参考文档 还给出了推荐的执行顺序先用 Firecrawl 抓取页面再并行拉取 SEO 数据domain_rank_overview、backlinks_summary 等最后用domain_intersection与自身域名对比。其中多竞争者场景可用backlinks_bulk_ranks一次对比多个域名的domain_rank。programmatic-seo规模化关键词模式验证programmatic-seo 技能 在「关键词模式研究」阶段需要验证需求聚合搜索量、分析头部与长尾的体量分布、观察趋势方向。DataForSEO 的search_volume与keywords for site接口正好提供程序化的数据基础——判断某个模板模式如「[服务] in [城市]」「[产品A] [产品B] integration」是否存在足够的搜索需求避免批量生成没有搜索量的「过度生成」页面。seo-audit审计报告的数据支撑seo-audit 技能 将 Ahrefs / Semrush 列为可用付费工具DataForSEO 在其中扮演同类的数据供应角色尤其适合需要 API 化、可重复执行的审计流程——例如用 On-Page instant pages audit 快速扫描站点核心页面用 backlinks summary 评估域名权威度基线作为审计报告的「Authority Links」环节证据。最佳实践与适用场景综合文档与仓库源码DataForSEO 的最佳应用场景可以归纳为程序化 SERP 大规模追踪批量、定时获取关键词排名不受手动查询次数限制带搜索量的关键词研究search_volume、competition、cpc三个字段即可完成关键词机会排序外链分析与监控summary、list、refdomains 三件套覆盖从总量到明细的完整链路On-Page SEO 审计instant pages 接口对单页做即时技术审计适合嵌入 CI 或定时巡检竞争对手分析Labs 系列接口与外链数据组合构建数据驱动的竞品画像实践注意事项始终优先使用 Live 接口做交互式查询大批量场景切换到 task-based 异步模式请求体必须是 JSON 数组单条也要包一层[]在代码中通过环境变量注入凭据配合--dry-run先行验证请求监控X-RateLimit-Remaining头提前规划限流应对策略用 CLI 的--location-code/--language-code参数替代默认值前先调用serp locations/serp languages确认取值合法相关资源DataForSEO 集成文档 — 本指南的原始依据dataforseo.js CLI 源码 — 全部命令与参数的实现细节CLI 通用约定 — 安装、认证、输出与安全规范工具注册表 — DataForSEO 在 SEO 工具分类中的定位competitor-profiling 工具参考 — 竞品分析场景的完整调用流程competitor-profiling 技能 — 竞品画像技能入口programmatic-seo 技能 — 规模化 SEO 页面构建技能入口seo-audit 技能 — SEO 审计技能入口赞分享AI 技能人工智能【免费下载链接】marketingskillsMarketing skills for Claude Code and AI agents. CRO, copywriting, SEO, analytics, and growth engineering.项目地址https://gitcode.com/GitHub_Trending/mar/marketingskills点击查看免费下载相关推荐AutoGPT 平台集成 DataForSEO关键词建议Keyword SuggestionsBlock 完整实战指南AutoGPT 平台集成 DataForSEO关键词建议Keyword SuggestionsBlock 完整实战指南 本指南围绕 AutoGPT 平台中人工智能AI Agent自主智能体Agent 工作流工作流自动化后端前端AutoGPT 中的 DataForSEO Related Keywords Block语义关键词发现与 SEO 指标提取实战指南AutoGPT 中的 DataForSEO Related Keywords Block语义关键词发现与 SEO 指标提取实战指南 导读 本文基于 relat人工智能AI Agent自主智能体Agent 工作流工作流自动化后端前端如何使用BiSeNet实现高效图像分割新手必备的完整教程如何使用BiSeNet实现高效图像分割新手必备的完整教程 BiSeNet是一个高效的图像分割框架包含BiSeNetV1和BiSeNetV2两个版本能够快速人工智能深度学习计算机视觉图像分割上一篇Eiten随机矩阵理论应用详解过滤市场噪声提升投资精度下一篇SUSI AI 智能魔镜模块项目推荐创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考