用途:该技能用于通过 Semrush API 检索 SEO、关键词、外链、流量与竞争情报数据。适用场景包括:分析域名排名、自然关键词、付费关键词或竞争对手;获取外链概览与引用域名数据;将 Semrush SEO API 报告拉取到分析或自动化工作流中。
主要能力:支持域名概览(domain_rank)、自然搜索关键词(domain_organic)、付费搜索关键词(domain_adwords)、自然搜索竞争对手(domain_organic_organic)、外链概览(backlinks_overview)以及引用域名(backlinks_refdomains)等报告。官方文档见 https://developer.semrush.com/api/get-started/quick-start/。
使用方式:先连接 Semrush 连接器(app.vm0.ai/connectors)。请求失败可运行诊断:zero doctor check-connector --env-name SEMRUSH_TOKEN 或 zero doctor check-connector --url "https://api.semrush.com/?type=domain_rank&domain=example.com&database=us&export_columns=Dn,Rk" --method GET。示例调用:curl -s "https://api.semrush.com/?type=domain_rank&key=$SEMRUSH_TOKEN&export_columns=Dn,Rk,Or,Ot,Oc,Ad,At,Ac&domain=<domain>&database=us"。自然关键词调用可加 display_limit 控制返回行数。外链概览使用 https://api.semrush.com/analytics/v1/?type=backlinks_overview 及 target_type=root_domain。
注意事项与限制:多数 SEO API 报告返回 CSV,未明确说明时不要假设为 JSON。API 使用量按单位计量,常按返回行数计费,应谨慎使用 display_limit。域名应传裸域名(如 example.com),除非端点明确接受 URL。需选择正确的区域数据库(如 us、uk、de)。使用 display_filter 或特殊字符时,可写入 /tmp/query.txt 并用 curl -G --data-urlencode "display_filter@/tmp/query.txt"。该技能的具体价格、配额上限等资料暂未提供。