本站每个工具背后的数据与分析管线,都可以在你自己的脚本、AI 客户端与自动化流程里直接调用:16 个组装接口(关键词难度、SERP 解密、网站估值、外链评估、页面体检……拿到的是结论)+ 14 个原始数据接口(谷歌搜索结果、DR、网站流量、搜索量、拓词、站点出词、域名注册状态……拿到的是料)+ 4 个方法论与知识库接口(哥飞 SEO Agent 的专题手册、哥飞知识库)——让你自己的 AI 按哥飞的方法查、按哥飞的口径答。
用 Web.Cafe 账号登录后生成令牌(wc_mcp_ 开头),每个令牌都通用于 HTTP API、MCP、命令行与 Skills。一个账号最多 10 个,建议每个地方单独一个(比如「Claude Code 笔记本」「选词脚本」):扣费明细里会写是哪个令牌花的,哪个泄露了就单删哪个,不影响别的。明文只显示一次,服务端只存哈希。
GET /api/v1/usage 拉取明细自动对账。credits.charged 与响应头 X-Credits-Charged 是本次实际扣的积分,X-Request-Id 与明细里的请求号一一对应。GET /api/v1/me;成功调用会在 credits 里返回本次扣费 charged 与剩余 balance(快见底时带 low)。积分不够时接口返回 402 与 code: "quota"(不扣费),到 积分中心 购买即可;余额够、但当天已到每日上限时返回 429 与 code: "day_cap",北京时间早上 8 点清零。站内工具的完整分析管线,与网页上看到的结果同一套算法、同一份缓存。
keyword_difficulty关键词难度(哥飞版 KD)2 积分/次0-100 难度分、中文判断原因、月搜索量、进入前十的链接预算、前十竞争盘面(DR/流量/域龄/体验分),自动识别品牌词。
网页版:关键词难度估算(哥飞版)(登录后每天有赠送额度,可以先在网页上试)
| 参数 | 类型 | 说明 |
|---|---|---|
keyword 必填 | string | 英文关键词,如 ai image editor |
gl | string | Google 国家代码,默认 us(可选 gb/ca/au/de/jp/sg 等) |
hl | string | 语言代码,默认 en |
force | boolean | 跳过 7 天结论缓存强制重算,默认 false |
curl -X POST https://seo.web.cafe/api/v1/keyword_difficulty \
-H "Authorization: Bearer $WEBCAFE_TOKEN" -H "Content-Type: application/json" \
-d '{"keyword":"ai image editor","gl":"us"}'
domain_overview网站流量概览2 积分/次一个域名的 DR、月访问量与近 6 个月走势、流量来源渠道与地区、用户行为、域龄、主力流量词、AI 引荐来源。
| 参数 | 类型 | 说明 |
|---|---|---|
domain 必填 | string | 域名,如 canva.com(不带协议与路径) |
curl -X POST https://seo.web.cafe/api/v1/domain_overview \
-H "Authorization: Bearer $WEBCAFE_TOKEN" -H "Content-Type: application/json" \
-d '{"domain":"canva.com"}'
website_worth网站估值2 积分/次整站价值区间 + 月收入估算 + 成色定性(红旗项),基于实时 DR、流量、来源结构、域龄与市场行情。
网页版:网站价值估算器(登录后每天有赠送额度,可以先在网页上试)
| 参数 | 类型 | 说明 |
|---|---|---|
domain 必填 | string | 域名 |
model | string | 变现方式:ai=AI 工具/订阅站(默认),adsense=广告内容站(ai / adsense) |
curl -X POST https://seo.web.cafe/api/v1/website_worth \
-H "Authorization: Bearer $WEBCAFE_TOKEN" -H "Content-Type: application/json" \
-d '{"domain":"example.com"}'
backlink_value外链价值评估2 积分/次从某个站买外链值不值:站点质量一票否决(链接农场/僵尸站识别)+ 8 万条真实挂牌价比价,给合理价区间与报价判断。
网页版:外链价值计算器(登录后每天有赠送额度,可以先在网页上试)
| 参数 | 类型 | 说明 |
|---|---|---|
domain 必填 | string | 卖外链的网站域名 |
price | number | 对方报价(美元),不知道就不传 |
linkType | string | 外链类型:guest(默认)/ home / niche / nav / nofollow(guest / home / niche / nav / nofollow) |
curl -X POST https://seo.web.cafe/api/v1/backlink_value \
-H "Authorization: Bearer $WEBCAFE_TOKEN" -H "Content-Type: application/json" \
-d '{"domain":"example.com","price":150}'
serp_reviewSERP 排名解密2 积分/次逐位点评一个词谷歌第一页的 10 个结果:凭什么排在那里、哪里可被超越、谁是薄弱占位,附整体难度与一眼结论。
网页版:SERP 排名解密(登录后每天有赠送额度,可以先在网页上试)
| 参数 | 类型 | 说明 |
|---|---|---|
keyword 必填 | string | 英文关键词 |
gl | string | Google 国家代码,默认 us(可选 gb/ca/au/de/jp/sg 等) |
curl -X POST https://seo.web.cafe/api/v1/serp_review \
-H "Authorization: Bearer $WEBCAFE_TOKEN" -H "Content-Type: application/json" \
-d '{"keyword":"ai logo generator"}'
page_coach页面军师3 积分/次自动推断页面在做什么关键词、核查谷歌实际排位与站内自相竞争,给 P0/P1/P2 分级的优化建议。
网页版:页面军师(登录后每天有赠送额度,可以先在网页上试)
| 参数 | 类型 | 说明 |
|---|---|---|
url 必填 | string | 完整页面 URL |
curl -X POST https://seo.web.cafe/api/v1/page_coach \
-H "Authorization: Bearer $WEBCAFE_TOKEN" -H "Content-Type: application/json" \
-d '{"url":"https://example.com/tool"}'
onpage_auditOn Page SEO 体检2 积分/次对一个页面围绕目标关键词做 40+ 项检测:总分、主题聚焦度、分类得分与逐项改进建议。
网页版:On Page SEO 体检(登录后每天有赠送额度,可以先在网页上试)
| 参数 | 类型 | 说明 |
|---|---|---|
url 必填 | string | 完整页面 URL |
keyword 必填 | string | 目标关键词(该页想排名的词) |
curl -X POST https://seo.web.cafe/api/v1/onpage_audit \
-H "Authorization: Bearer $WEBCAFE_TOKEN" -H "Content-Type: application/json" \
-d '{"url":"https://example.com/tool","keyword":"ai image editor"}'
translate_demand需求翻译器2 积分/次一句英文需求 → 有真实搜索支撑的关键词:搜谷歌前十、逐页分析正文与标题结构、交叉验证相关搜索,给分档推荐词。
网页版:需求翻译器(登录后每天有赠送额度,可以先在网页上试)
| 参数 | 类型 | 说明 |
|---|---|---|
query 必填 | string | 英文需求描述(≤20 词),如 turn my photo into anime style |
curl -X POST https://seo.web.cafe/api/v1/translate_demand \
-H "Authorization: Bearer $WEBCAFE_TOKEN" -H "Content-Type: application/json" \
-d '{"query":"turn my photo into anime style"}'
adsense_auditAdSense 过审预检3 积分/次对照 AdSense 官方审核要求逐项体检一个网站:可访问性、政策页、内容量、广告代码、ads.txt、隐私合规等,给修复清单。
网页版:AdSense 过审预检(登录后每天有赠送额度,可以先在网页上试)
| 参数 | 类型 | 说明 |
|---|---|---|
site 必填 | string | 网站域名或首页 URL,如 example.com |
curl -X POST https://seo.web.cafe/api/v1/adsense_audit \
-H "Authorization: Bearer $WEBCAFE_TOKEN" -H "Content-Type: application/json" \
-d '{"site":"example.com"}'
brand_naming网站起名2 积分/次 起;起名本身按所用模型档位计,每次域名/撞名核查另计,按实际发生合计给产品/网站起英文品牌名,并逐个核查:各后缀能否注册、谷歌会不会把它纠正成别的词、有没有撞名。
网页版:网站起名 AI(登录后每天有赠送额度,可以先在网页上试)
| 参数 | 类型 | 说明 |
|---|---|---|
brief 必填 | string | 产品/网站是做什么的、面向哪个市场、想要什么风格 |
count | integer | 候选个数,3~12,默认 8 |
tlds | array | 要核查的后缀,默认 ['.com','.ai','.io'] |
curl -X POST https://seo.web.cafe/api/v1/brand_naming \
-H "Authorization: Bearer $WEBCAFE_TOKEN" -H "Content-Type: application/json" \
-d '{"brief":"AI 简历生成器,面向欧美求职者,专业感强、好记","count":6}'
domain_review域名精评3 积分/次按固定标准给一批域名打分(1~10):好记、好读、有含义、品牌感、EMD/SEO 潜力,附一句理由与适合做什么。
网页版:网站起名 AI(登录后每天有赠送额度,可以先在网页上试)
| 参数 | 类型 | 说明 |
|---|---|---|
domains 必填 | array | 要评的完整域名,≤60 个 |
brief | string | 用途/偏好,一句话 |
curl -X POST https://seo.web.cafe/api/v1/domain_review \
-H "Authorization: Bearer $WEBCAFE_TOKEN" -H "Content-Type: application/json" \
-d '{"domains":["lvyou.com","getcloud.ai"]}'
bulk_domain_scan域名批量生成并查注册2 积分/次 起;按实际打到上游的域名数,每 20 个 1.5 积分(缓存命中免费)按「名称一 + 字典一 + 名称二 + 字典二 + 名称三」五槽规则批量生成域名,实时核查能不能注册。
网页版:域名批量查询(登录后每天有赠送额度,可以先在网页上试)
| 参数 | 类型 | 说明 |
|---|---|---|
n1 | string | 名称一(固定文本,可空) |
dict1 | string | 字典一:py 拼音 / py1~py4 一~四位拼音 / pydup 叠拼 / initials 声母 / en 英文单词等,默认 py |
custom1 | array | dict1 为 custom 时的词表 |
n2 | string | 名称二(可空) |
dict2 | string | 字典二,默认 none |
custom2 | array | dict2 为 custom 时的词表 |
n3 | string | 名称三(可空) |
tlds | array | 后缀,带点,默认 ['.com'] |
maxLen | integer | 名字总长度上限(不含后缀),0 = 不限 |
limit | integer | 本次查多少个组合,默认 100,上限 200 |
offset | integer | 从第几个组合开始(翻页用) |
onlyAvailable | boolean | 只返回可注册的,默认 true |
curl -X POST https://seo.web.cafe/api/v1/bulk_domain_scan \
-H "Authorization: Bearer $WEBCAFE_TOKEN" -H "Content-Type: application/json" \
-d '{"n1":"ai","dict1":"py2","tlds":[".com"],"limit":50}'
search_known_sites站点库检索1 积分/次在本站沉淀的域名档案里按 DR / 月访问量 / 域龄 / 内容词筛站;传 rankingKeyword 可反查谁在某个词上有排名。
| 参数 | 类型 | 说明 |
|---|---|---|
terms | array | 匹配词(小写英文,1~4 个,任一命中即可) |
rankingKeyword | string | 反查:哪些站在这个词上有排名 |
registeredWithinMonths | number | 只要最近 N 个月注册的 |
minVisits | number | 月访问量下限 |
maxVisits | number | 月访问量上限 |
minDr | number | DR 下限 |
maxDr | number | DR 上限 |
orderBy | string | visits(默认)/ newest(visits / newest) |
limit | number | 返回条数,默认 20,最多 30 |
curl -X POST https://seo.web.cafe/api/v1/search_known_sites \
-H "Authorization: Bearer $WEBCAFE_TOKEN" -H "Content-Type: application/json" \
-d '{"terms":["ai","resume"],"maxDr":40,"registeredWithinMonths":12}'
search_known_keywords关键词库检索1 积分/次在本站沉淀的关键词里检索:算过哥飞版 KD 的词(分与等级)+ 快照库词表(搜索量、CPC、预筛难度、意图)。
| 参数 | 类型 | 说明 |
|---|---|---|
terms | array | 关键词包含匹配(小写英文,1~4 个) |
maxScore | number | 哥飞版 KD 上限 |
minScore | number | 哥飞版 KD 下限 |
minVolume | number | 月搜索量下限 |
maxKd | number | 预筛难度上限 |
intent | string | 搜索意图(informational / navigational / commercial / transactional) |
gl | string | 国家,默认 us;world = 全球合计 |
limit | number | 返回条数,默认 20,最多 30 |
curl -X POST https://seo.web.cafe/api/v1/search_known_keywords \
-H "Authorization: Bearer $WEBCAFE_TOKEN" -H "Content-Type: application/json" \
-d '{"terms":["generator"],"maxScore":30}'
stripe_checkout_referralsStripe 引荐流量榜1 积分/次哪些网站给 Stripe 收银台送去最多付费流量(2024 年 1 月起逐月):大盘走势、月榜、单站逐月历史、黑马名单。
网页版:Stripe 引荐流量榜(登录后每天有赠送额度,可以先在网页上试)
| 参数 | 类型 | 说明 |
|---|---|---|
view | string | overview(默认)/ month / site(overview / month / site) |
month | string | 月份 YYYYMM |
domain | string | 域名(view=site 必填) |
recentMonths | number | overview 返回最近 N 个月,默认 6,最多 12 |
curl -X POST https://seo.web.cafe/api/v1/stripe_checkout_referrals \
-H "Authorization: Bearer $WEBCAFE_TOKEN" -H "Content-Type: application/json" \
-d '{"view":"overview"}'
find_link_prospects外链资源筛选1 积分/次在 8 万+ 条 Guest Post 挂牌快照里按 DR / 月流量 / 自然搜索占比 / 价格筛选值得考察的卖链站点。
| 参数 | 类型 | 说明 |
|---|---|---|
minDr | number | DR 下限,默认 20 |
maxDr | number | DR 上限 |
minTraffic | number | 月流量下限,默认 1000 |
minOrganicPct | number | 自然搜索占比下限(%),默认 15 |
maxPrice | number | 预算上限(美元) |
orderBy | string | dr(默认)/ traffic / price(dr / traffic / price) |
limit | number | 返回条数,默认 12,最多 20 |
curl -X POST https://seo.web.cafe/api/v1/find_link_prospects \
-H "Authorization: Bearer $WEBCAFE_TOKEN" -H "Content-Type: application/json" \
-d '{"minDr":40,"maxPrice":100}'
站内哥飞 SEO Agent 的「脑子」:专题手册告诉 AI 该先查什么、数据怎么解读;知识库检索只给线索,阅读只给与问题相关的段落,每个账号每天可读取的量有上限。
load_guide方法论手册每本 1.5 积分(合计向上取整,最低 1 积分)站内哥飞 SEO Agent 用的专题手册:该先查什么、各项数据的口径怎么解读、哪些结论不能下。让你自己的 AI 照哥飞的方法做事。
| 参数 | 类型 | 说明 |
|---|---|---|
topics 必填 | array | 手册名,1~3 本:keyword(选词)/ newwords(新词)/ domains(域名)/ traffic(查流量)/ attribution(流量归因)/ discovery(找站找词)/ backlinks(外链)/ knowledge(知识库引用)/ gsc / chart / memory |
curl -X POST https://seo.web.cafe/api/v1/load_guide \
-H "Authorization: Bearer $WEBCAFE_TOKEN" -H "Content-Type: application/json" \
-d '{"topics":["keyword"]}'
knowledge_ask问哥飞8 积分/次问「哥飞怎么看 / 哥飞说过什么」首选这个:一次调用在哥飞知识库里检索、挑最相关的几篇,把每篇里与问题相关的段落连同出处与日期一起返回。一个问题调一次就够,不用自己再逐篇检索阅读。
| 参数 | 类型 | 说明 |
|---|---|---|
question 必填 | string | 你的问题,如「怎么找新词」「新站多久开始做外链」 |
kind | string | 只看某类(tutorial / experience / post / wechat / daily_summary / chat) |
after | string | 只看这个日期之后的,YYYY-MM-DD |
curl -X POST https://seo.web.cafe/api/v1/knowledge_ask \
-H "Authorization: Bearer $WEBCAFE_TOKEN" -H "Content-Type: application/json" \
-d '{"question":"怎么找新词"}'
knowledge_search哥飞知识库检索4 积分/次只要线索时用:在哥飞知识库里检索,返回命中文档的标题、日期、链接和简短节选(不是全文)。要答案请直接用 knowledge_ask。
| 参数 | 类型 | 说明 |
|---|---|---|
query 必填 | string | 检索词,2~6 字/词为佳,如「外链 价格」 |
kind | string | 只看某类(tutorial / experience / post / wechat / daily_summary / chat) |
after | string | 只看这个日期之后的,YYYY-MM-DD |
limit | integer | 最多几条,默认 5,最多 5 |
curl -X POST https://seo.web.cafe/api/v1/knowledge_search \
-H "Authorization: Bearer $WEBCAFE_TOKEN" -H "Content-Type: application/json" \
-d '{"query":"新站 外链"}'
knowledge_read哥飞知识库阅读每 200 字 1 积分(按实际返回量计,最低 1 积分)用户追问某一篇的细节时才用:带着问题读一篇知识库文档,只返回文中与问题最相关的段落(不是全文),群聊只提供哥飞本人的发言(及他回答的那条提问,去掉昵称)。
| 参数 | 类型 | 说明 |
|---|---|---|
docId 必填 | string | 文档 id,来自 knowledge_search 的结果 |
query 必填 | string | 你想从这篇里找什么(用来挑段落) |
curl -X POST https://seo.web.cafe/api/v1/knowledge_read \
-H "Authorization: Bearer $WEBCAFE_TOKEN" -H "Content-Type: application/json" \
-d '{"docId":"doc_xxx","query":"新站多久开始做外链"}'
未经加工的一手数据,适合自己建模、批量入库或喂给自己的 Agent。
serp谷歌搜索结果2 积分/次谷歌实时搜索结果原始数据:自然结果(含 sitelinks)、相关搜索、People Also Ask、知识面板等(7 天缓存)。
| 参数 | 类型 | 说明 |
|---|---|---|
q 必填 | string | 搜索词(≤200 字符) |
gl | string | Google 国家代码,默认 us(可选 gb/ca/au/de/jp/sg 等) |
hl | string | 语言代码,默认 en |
curl -X POST https://seo.web.cafe/api/v1/serp \
-H "Authorization: Bearer $WEBCAFE_TOKEN" -H "Content-Type: application/json" \
-d '{"q":"best ai image editor","gl":"us"}'
domain_drAhrefs DR(域名权重)每 20 个域名 1.5 积分(合计向上取整,最低 1 积分);只按真正查询上游并拿到结论的域名计,缓存命中与查询失败不收费批量查询域名的 Ahrefs Domain Rating(0~100),一次最多 100 个。30 天内查过的走缓存不收费;Ahrefs 没有数据的新域名返回 noData(这类结果缓存 7 天)。
网页版:DR 批量查询(登录后每天有赠送额度,可以先在网页上试)
| 参数 | 类型 | 说明 |
|---|---|---|
domains 必填 | array | 域名数组,1~100 个(可带 http:// 与路径,会自动规整) |
curl -X POST https://seo.web.cafe/api/v1/domain_dr \
-H "Authorization: Bearer $WEBCAFE_TOKEN" -H "Content-Type: application/json" \
-d '{"domains":["canva.com","figma.com"]}'
domain_traffic网站流量数据每个域名 1.5 积分(合计向上取整,最低 1 积分)批量查询 SimilarWeb 口径整站流量:月访问量、逐月历史、渠道与地区分布、用户行为、主力流量词、域名注册时间。
| 参数 | 类型 | 说明 |
|---|---|---|
domains 必填 | array | 域名数组,1~50 个 |
force | boolean | 跳过缓存强制刷新,默认 false |
curl -X POST https://seo.web.cafe/api/v1/domain_traffic \
-H "Authorization: Bearer $WEBCAFE_TOKEN" -H "Content-Type: application/json" \
-d '{"domains":["canva.com"]}'
domain_availability域名注册状态每 20 个域名 1.5 积分(合计向上取整,最低 1 积分)批量查询域名能否注册、注册时间与到期时间(缓存优先)。
网页版:域名批量查询(登录后每天有赠送额度,可以先在网页上试)
| 参数 | 类型 | 说明 |
|---|---|---|
domains 必填 | array | 完整域名数组,1~100 个,如 ['mytool.com','mytool.ai'] |
curl -X POST https://seo.web.cafe/api/v1/domain_availability \
-H "Authorization: Bearer $WEBCAFE_TOKEN" -H "Content-Type: application/json" \
-d '{"domains":["mytool.com","mytool.ai"]}'
keyword_volume关键词搜索量2 积分/次 起;视数据口径最高 5 积分/次;gl=world 真打上游时另加 15 积分Google Ads 关键字规划师口径:月均搜索量、近 12 个月逐月曲线、竞争度、顶部出价区间(14 天缓存)。
| 参数 | 类型 | 说明 |
|---|---|---|
keywords 必填 | array | 英文关键词数组,1~50 个 |
gl | string | 国家代码,默认 us;world = 全球合计 |
hl | string | 语言代码,默认 en |
curl -X POST https://seo.web.cafe/api/v1/keyword_volume \
-H "Authorization: Bearer $WEBCAFE_TOKEN" -H "Content-Type: application/json" \
-d '{"keywords":["ai photo editor","photo to text"]}'
google_trends谷歌趋势2 积分/次 起;共享缓存命中 2 积分;实时抓取 4 积分;related=true 且相关查询要实时抓取时另加 4 积分;数据不足或取不到不收费(会员价,非会员见展开的说明)Google Trends 相对热度曲线(0~100):过去 7 天按小时、30 / 90 天按天、12 个月 / 5 年按周,最后一个没过完的点标 partial;最多 5 个词放进同一次查询对比;单个词可带「上升最快 / 最热门的相关查询」。每次都附一份趋势面判断:是不是新词、处于什么时期、适不适合上站(只看曲线形状)。全站共享缓存优先。
网页版:谷歌趋势查询(登录后每天有赠送额度,可以先在网页上试)
计费(会员价):2 积分/次 起;共享缓存命中 2 积分;实时抓取 4 积分;related=true 且相关查询要实时抓取时另加 4 积分;数据不足或取不到不收费。上面是会员价。非会员:共享缓存命中 1 积分、实时抓取 2 积分、相关查询要实时抓取另加 2 积分——积分数少,是因为非会员的积分买得贵(积分包 1 元 10 分起,会员 1 元 40 分起),折成钱非会员花得更多:同样实时抓取一次,会员约 ¥0.10,非会员约 ¥0.20。按调用那一刻的身份算,会员过期后按非会员价;接入 MCP 后工具列表里显示的就是你自己身份的价格。实时抓取 = 共享缓存里没有、这次去谷歌趋势现取;缓存按时间范围保留 6 小时(7 天)到 7 天(5 年)。
| 参数 | 类型 | 说明 |
|---|---|---|
keyword | string | 关键词(英文为主),如 ai video |
compare | array | 和 keyword 放进同一次查询对比的词,最多 4 个 |
range | string | 时间范围,默认 12m(7d / 30d / 90d / 12m / 5y) |
geo | string | 两位国家代码,如 US;不传 = 全球 |
related | boolean | 是否同时返回相关查询(上升最快 / 最热门),默认 false;对比时不支持 |
url | string | 也可以直接给谷歌趋势网址(trends.google.com/trends/explore?…),词、时间范围、地区照网址 |
| data 字段 | 说明 |
|---|---|
keywords | 这次查询的词:第一个是 keyword,其余是 compare(统一转成小写) |
geo / range / granularity | 地区(空 = 全球)、时间范围、粒度(hour / day / week) |
source / fetchedAt | live = 这次实时抓取,cache = 全站共享缓存;fetchedAt 是数据取回的时间(Unix 秒) |
points[] | time(UTC 日期或时间)、timestamp、value(0~100;对比时是第一个词的)、values(对比时每个词一个,顺序同 keywords)、partial(最后一个没过完的时间段,别当成下跌;上游没标的,按取数时间和「最后几个点突然是 0」也会标上)、gap(前后都有像样热度、中间突然掉到 0:谷歌没给数或统计缺口,不是热度掉到 0;只在按小时 / 按天的曲线里认) |
latestWave | 单个词时给:最新一波从哪个时间点起来(start)、哪个时间点到顶(peak)、峰值(peakValue)、起来之前的最高值(before);没有明显的新一波时不给 |
related | 单个词时给:rising[](上升最快:query、value、breakout、growth)与 top[](最热门:query、value)、fetchedAt;上升最快偏少(最热门 ≥ 10 个、上升最快不到 5 个,换住宅代理重取过还是少)时带 thin: true 和 note——谷歌趋势网页版上可能更多。共享缓存里有就顺带给、不另收;没有且没带 related=true 时为 null |
insight | 单个词时给的趋势面判断(只看曲线形状,不看搜索量和竞争):newWord { verdict: new / likely_new / old / unknown, appearedAt, ageDays, why };stage { key, label, why }(萌芽期、爆发期、上升期、高峰期、平稳期、季节性、回落期、一次性热点、过气、起伏不定、数据太少);site { verdict: recommended / consider / caution / avoid / unknown, label, why, next };metrics(峰值、最新值、近期动量 momentumPct、最新 / 峰值 latestVsPeak、波动 volatility、5 年的季节性 seasonality、谷歌没给数的点数 gaps 等;过去 7 天按小时的有昼夜起伏,时期按 24 小时均值判,另给 smoothing(值为 24h)、recentAvg、peakAvg)。partial、gap 的点不参与判断。判新词以 12 个月或 5 年为准,短窗口最多给 likely_new |
insights | 对比时给:按词名各一份 insight。几个词共用一把尺子,小词会被压扁,要判断某个词请单独查它的 12m |
note / relatedNote | 口径说明;相关查询这次没取到时说明原因(没取到的部分不收费) |
curl -X POST https://seo.web.cafe/api/v1/google_trends \
-H "Authorization: Bearer $WEBCAFE_TOKEN" -H "Content-Type: application/json" \
-d '{"keyword":"ai video","range":"12m","related":true}'
trends_rising谷歌趋势找新词2 积分/次 起;共享缓存里的词根这次合起来 2 积分;每实时抓取一个词根 4 积分(一次最多 8 个);取不到不收费(会员价,非会员见展开的说明)一批词根在谷歌趋势里的「上升最快的相关查询」合并排好(Breakout = 涨 5000% 以上),哥飞挖新词的办法;不给词根就用哥飞的工具站词根表(preset=default)或 AI 词根表(preset=ai)。共享缓存里的词根直接用,没缓存的每次最多实时抓取 8 个,其余列在 notReached、下次接着查。排在前面的词如果我们判断过(有人单独查过它的 12 个月),一并带上是不是新词、处于什么时期、适不适合上站。
网页版:谷歌趋势查询(登录后每天有赠送额度,可以先在网页上试)
计费(会员价):2 积分/次 起;共享缓存里的词根这次合起来 2 积分;每实时抓取一个词根 4 积分(一次最多 8 个);取不到不收费。上面是会员价。非会员:共享缓存里的合起来 1 积分、每实时抓取一个词根 2 积分——积分数少,是因为非会员的积分买得贵(积分包 1 元 10 分起,会员 1 元 40 分起),折成钱非会员花得更多:每实时抓取一个词根,会员约 ¥0.10,非会员约 ¥0.20。按调用那一刻的身份算,会员过期后按非会员价;接入 MCP 后工具列表里显示的就是你自己身份的价格。
| 参数 | 类型 | 说明 |
|---|---|---|
roots | array | 词根数组,最多 20 个,如 ['generator','ai video'];不传就用预设词根表 |
preset | string | 预设词根表:default 工具站词根 / ai AI 相关词根(default / ai) |
range | string | 时间范围,默认 30d(7d / 30d / 90d) |
geo | string | 两位国家代码,如 US;不传 = 全球 |
max_fetch | integer | 这次最多实时抓取几个没缓存的词根,默认 8,最多 8 |
| data 字段 | 说明 |
|---|---|
range / geo / preset | 时间范围、地区(空 = 全球)、用的预设词根表(给了 roots 时为 null) |
roots[] | 这次查到的词根:root、source(live 实时抓取 / cache 共享缓存)、rising(这个词根有几个上升最快的相关查询) |
items[] | 合并排好的词:query、roots(从哪几个词根冒出来)、rising(Breakout 或 +X%)、breakout、growth(涨幅百分比,Breakout 记 5000) |
items[].known | 前 20 个词里我们判断过的才有:newWord(new / likely_new / old / unknown)、appearedAt、stage(时期)、site(上站结论)、checkedAt(判断的时间)。没有 known 不代表不是新词,只是还没人单独查过它 |
notReached / failed | 这次没轮到的词根(再调一次接着查);没取到的词根和原因(不收费) |
note | 口径说明:飙升只说明最近搜的人在猛涨,不等于新词、更不等于有量 |
curl -X POST https://seo.web.cafe/api/v1/trends_rising \
-H "Authorization: Bearer $WEBCAFE_TOKEN" -H "Content-Type: application/json" \
-d '{"preset":"ai","range":"30d"}'
keyword_ideas拓词每 50 个返回词 7.5 积分(按实际返回量计,最低 8 积分)关键词快照库拓词:每个词带月搜索量、近 3 月趋势、CPC、竞争度、预筛难度、搜索意图。
网页版:关键词拓展(登录后每天有赠送额度,可以先在网页上试)
| 参数 | 类型 | 说明 |
|---|---|---|
seeds 必填 | array | 英文种子词,1~20 个 |
mode | string | ideas(同品类,默认)/ suggestions(长尾)/ related(相关搜索)(ideas / suggestions / related) |
gl | string | 国家代码,默认 us;world = 全球合计 |
hl | string | 语言代码 |
limit | integer | 最多几个,默认 50,上限 200 |
minVolume | integer | 月搜索量下限 |
maxKd | integer | 预筛难度上限 |
curl -X POST https://seo.web.cafe/api/v1/keyword_ideas \
-H "Authorization: Bearer $WEBCAFE_TOKEN" -H "Content-Type: application/json" \
-d '{"seeds":["ai headshot"],"limit":50}'
site_keywords站点出词每 50 个返回词 7.5 积分(按实际返回量计,最低 8 积分)一个域名或网页在谷歌排名的关键词:位置、月搜索量、带来的估算流量、预筛难度、意图、落地页,附排名概览。
网页版:站点出词(登录后每天有赠送额度,可以先在网页上试)
| 参数 | 类型 | 说明 |
|---|---|---|
target 必填 | string | 域名(整站)或完整网址(单页) |
gl | string | Google 国家代码,默认 us(可选 gb/ca/au/de/jp/sg 等) |
hl | string | 语言代码 |
orderBy | string | etv(默认)/ volume / position(etv / volume / position) |
limit | integer | 最多几个,默认 50,上限 200 |
curl -X POST https://seo.web.cafe/api/v1/site_keywords \
-H "Authorization: Bearer $WEBCAFE_TOKEN" -H "Content-Type: application/json" \
-d '{"target":"photoroom.com","limit":50}'
site_history站点搜索流量历史8 积分/次一个域名逐月的自然搜索排名词数、估算搜索流量、位次分布、新进/掉出(默认 12 个月,上限 24)。
| 参数 | 类型 | 说明 |
|---|---|---|
target 必填 | string | 域名,如 example.com |
gl | string | Google 国家代码,默认 us(可选 gb/ca/au/de/jp/sg 等) |
hl | string | 语言代码 |
months | integer | 最近几个月,默认 12,上限 24 |
curl -X POST https://seo.web.cafe/api/v1/site_history \
-H "Authorization: Bearer $WEBCAFE_TOKEN" -H "Content-Type: application/json" \
-d '{"target":"photoroom.com","months":12}'
bulk_keyword_difficulty批量难度预筛5 积分/次一次给最多 200 个词拿快照库口径的难度分(海选预筛用;精评请用 keyword_difficulty)。
| 参数 | 类型 | 说明 |
|---|---|---|
keywords 必填 | array | 关键词数组,1~200 个 |
gl | string | Google 国家代码,默认 us(可选 gb/ca/au/de/jp/sg 等) |
hl | string | 语言代码 |
curl -X POST https://seo.web.cafe/api/v1/bulk_keyword_difficulty \
-H "Authorization: Bearer $WEBCAFE_TOKEN" -H "Content-Type: application/json" \
-d '{"keywords":["ai headshot generator","linkedin photo ai"]}'
search_intent搜索意图分类5 积分/次给最多 200 个词判断搜索意图(信息 / 导航 / 商业 / 交易),附置信度与次意图。
| 参数 | 类型 | 说明 |
|---|---|---|
keywords 必填 | array | 关键词数组,1~200 个 |
hl | string | 语言代码,默认 en |
curl -X POST https://seo.web.cafe/api/v1/search_intent \
-H "Authorization: Bearer $WEBCAFE_TOKEN" -H "Content-Type: application/json" \
-d '{"keywords":["buy domain","what is seo"]}'
domain_timeline域名历史快照时间线2 积分/次Internet Archive 收录时间线:第一次/最近一次快照、分几段在用、每段多久、中间空窗多长,以及当前 whois(7 天缓存)。
网页版:域名前世档案(登录后每天有赠送额度,可以先在网页上试)
| 参数 | 类型 | 说明 |
|---|---|---|
domain 必填 | string | 裸域名,如 example.com |
curl -X POST https://seo.web.cafe/api/v1/domain_timeline \
-H "Authorization: Bearer $WEBCAFE_TOKEN" -H "Content-Type: application/json" \
-d '{"domain":"example.com"}'
fetch_url抓取网页1 积分/次按搜索引擎首轮抓取口径抓一个 URL(不执行 JS,跟随重定向):原始源码,或抽取后的可读正文与标题层级。
| 参数 | 类型 | 说明 |
|---|---|---|
url 必填 | string | 完整 URL |
mode | string | source=原始源码(默认)/ text=可读正文(source / text) |
curl -X POST https://seo.web.cafe/api/v1/fetch_url \
-H "Authorization: Bearer $WEBCAFE_TOKEN" -H "Content-Type: application/json" \
-d '{"url":"https://example.com/","mode":"text"}'
机器可读的完整目录:GET /api/v1/tools · OpenAPI 3.1:/api/openapi.json(可直接导入 Postman、ChatGPT GPTs Actions 等)。
https://seo.web.cafe/api/v1/<接口>,POST JSON 请求体,或 GET 查询参数(数组用逗号分隔)Authorization: Bearer 你的令牌(不方便加请求头时可用 ?token=)curl -X POST https://seo.web.cafe/api/v1/keyword_difficulty \
-H "Authorization: Bearer $WEBCAFE_TOKEN" -H "Content-Type: application/json" \
-d '{"keyword":"ai image editor","gl":"us"}'
curl "https://seo.web.cafe/api/v1/domain_traffic?domains=canva.com,figma.com" \
-H "Authorization: Bearer $WEBCAFE_TOKEN"
{
"ok": true,
"tool": "keyword_difficulty",
"requestId": "req_3f9c…", // 与积分明细里的请求号对应
"credits": { "charged": 2 }, // 本次实际扣的积分
"data": { … }, // 结构化结果
"markdown": "# …" // 可读报告(部分接口有)
}
| HTTP | code | 含义与处理 |
|---|---|---|
| 400 | param | 参数缺失或格式不对,未扣费。按 error 修正后重试 |
| 401 | auth | 令牌无效或已重置,到本页重新生成 |
| 402 | quota | 积分余额不够这一次(API 不使用每日赠送额度),到积分中心购买 |
| 404 | not_found | 没有这个接口,看 /api/v1/tools |
| 429 | rate | 每分钟调用次数超限,稍后重试 |
| 502 / 503 | upstream / unavailable | 上游数据源故障或暂不可用,积分已自动退回 |
curl https://seo.web.cafe/api/v1/me -H "Authorization: Bearer $WEBCAFE_TOKEN"
curl "https://seo.web.cafe/api/v1/usage?limit=50&scope=api" -H "Authorization: Bearer $WEBCAFE_TOKEN"
MCP 地址:https://seo.web.cafe/api/mcp(Streamable HTTP)。接入后全部 34 个接口都会作为工具出现,工具描述里带着价格,每次结果末尾注明本次扣了多少积分。
# Claude Code
claude mcp add --transport http gefei https://seo.web.cafe/api/mcp \
--header "Authorization: Bearer 你的令牌"
# Cursor / Windsurf 等(mcp.json)
{ "mcpServers": { "gefei": { "url": "https://seo.web.cafe/api/mcp",
"headers": { "Authorization": "Bearer 你的令牌" } } } }
Claude.ai 网页版 / Desktop:设置 → Connectors → Add custom connector,URL 填 https://seo.web.cafe/api/mcp?token=你的令牌,Advanced settings 里的 OAuth 两个框留空。注意带令牌的 URL 就是凭证,别截图外传。
以前接入的 https://seo.web.cafe/kd/mcp 继续可用,同样能看到全部工具。
站内的 哥飞 SEO Agent = 大模型 + 哥飞的方法论 + 这些工具 + 哥飞知识库。接入 MCP 之后,模型换成你自己的 Claude,其余几样照样都在:
load_guide 按问题取选词 / 新词 / 域名 / 流量 / 归因 / 外链等专题手册,和站内 Agent 用的是同一套。knowledge_search 找哥飞说过什么,knowledge_read 带着问题读相关段落。/mcp__gefei__keywords 这样的斜杠命令,Claude Desktop 在输入框的「+」里选;装了下面的 Skills 更顺手,直接 /gefei-keywords。自己写程序调 Claude / OpenAI 的,用 GET /api/v1/agent-kit(加 ?format=openai 给 OpenAI 格式)一次拿到 system 提示词和全部工具定义,放进你的工具调用循环;模型要调哪个工具,就把参数 POST 到 /api/v1/<工具名>,把响应里的 markdown(没有就用 data)交回给模型。大模型费用在你那边,我们只按工具调用扣积分。
一个零依赖的 Node.js 脚本(Node 18+),接口清单从服务端实时拉取,新接口上线不用更新脚本。
# 安装(macOS / Linux)
curl -fsSL https://seo.web.cafe/api/cli/webcafe.mjs -o /usr/local/bin/webcafe && chmod +x /usr/local/bin/webcafe
# Windows:下载后用 node webcafe.mjs 运行
webcafe login 你的令牌
webcafe tools # 全部接口与价格
webcafe keyword_difficulty "ai image editor"
webcafe domain_traffic canva.com,figma.com --json
webcafe keyword_ideas "ai headshot" --limit 100 --out ideas.json
webcafe me # 余额
webcafe usage --api # API 扣费明细
把工具箱装成 Claude 的一项技能:它会在你问到选词、竞品流量、域名、页面优化时自己调用合适的接口,并在回答里注明花了多少积分。技能包里带着上面那个命令行。
# Claude Code:装到个人技能目录
mkdir -p ~/.claude/skills && cd ~/.claude/skills \
&& curl -fsSL https://seo.web.cafe/api/skills/gefei-skills.zip -o gefei-skills.zip \
&& unzip -o gefei-skills.zip && rm gefei-skills.zip
export WEBCAFE_TOKEN=你的令牌 # 或运行一次 node ~/.claude/skills/gefei/scripts/webcafe.mjs login 你的令牌
装好后在 Claude Code 里输入 /gefei 就能看到全部命令:
| 命令 | 做什么 |
|---|---|
/gefei 你的问题 | 哥飞 SEO 顾问:任何 SEO / 出海建站问题(不打命令、直接问 SEO 问题时也会自动启用) |
/gefei-keywords ai headshot | 选词:拓词 → 海选 → 哥飞版 KD 精评 → 核实搜索量 |
/gefei-competitor photoroom.com | 拆竞品:流量盘子、渠道、靠哪些词、能学什么 |
/gefei-domain example.com 500 | 买域名 / 买站前尽调(可带报价美元) |
/gefei-page https://… 目标词 | 优化一个页面:体检 + 军师 + 排名盘面 |
接了上面的 MCP 时,这些命令直接调 MCP 工具;没接时用技能自带的命令行,两种都行。
Claude.ai:设置 → Capabilities → Skills → Upload skill,上传 gefei.zip(Claude.ai 一次只能传一个技能;更推荐在 Claude.ai 用上面的 MCP 连接器)。技能说明:SKILL.md。