SuperAPI AI 工具集

dataforseo

数据与分析

查看项目

更新于 10-15 20:09

技能介绍

用途:该技能用于通过 DataForSEO 查询关键词排名、搜索量与 SEO 指标,适用于用户询问 SEO 表现、关键词排名或自然搜索数据的场景。

连接方式:基础地址为 https://api.dataforseo.com/v3,使用 Basic 认证,即 Base64($DATAFORSEO_LOGIN:$DATAFORSEO_PASSWORD),所需环境变量为 DATAFORSEO_LOGIN 与 DATAFORSEO_PASSWORD。内置 6 小时内存缓存,最多 50 条。

主要能力:服务端库文件为 server/lib/dataforseo.ts,导出函数包括 getRelevantBlogPages(limit?, offset?) 获取带 SEO 指标的博客页面、getAllBlogPagesSeo() 获取全部博客页面(分页,最多 1000)、getTopBlogKeywords(limit?, offset?) 获取排名靠前的关键词、getAllTopBlogKeywords(maxResults?) 获取全部热门关键词、getRankedKeywordsForPage(blogSlug, limit?) 获取指定博客文章的关键词。

使用方式:可通过脚本调用,例如查看热门关键词:pnpm action seo-top-keywords --fields=keyword,rank_absolute,etv;搜索特定关键词:pnpm action seo-top-keywords --grep=remix --fields=keyword,rank_absolute,etv。

注意事项:API 采用异步任务模型,响应中 tasks[] 的 status_code 为 20000 表示成功;响应结构为 tasks[].result[0].items;过滤使用请求体中的类 SQL filter 数组,代码中过滤 /blog/%;getAllBlogPagesSeo 以 100 为步长分页,默认最多 1000;错误会包含 DataForSEO 任务状态码与消息。其余细节暂未提供。