本站每个工具背后的数据与分析管线,都可以在你自己的脚本、AI 客户端与自动化流程里直接调用:16 个组装接口(关键词难度、SERP 解密、网站估值、外链评估、页面体检……拿到的是结论)+ 12 个原始数据接口(谷歌搜索结果、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 个结果:凭什么排在那里、哪里可被超越、谁是薄弱占位,附整体难度与一眼结论。
| 参数 | 类型 | 说明 |
|---|---|---|
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+ 项检测:总分、主题聚焦度、分类得分与逐项改进建议。
| 参数 | 类型 | 说明 |
|---|---|---|
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、隐私合规等,给修复清单。
| 参数 | 类型 | 说明 |
|---|---|---|
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 积分/次 起;起名本身按所用模型档位计,每次域名/撞名核查另计,按实际发生合计给产品/网站起英文品牌名,并逐个核查:各后缀能否注册、谷歌会不会把它纠正成别的词、有没有撞名。
| 参数 | 类型 | 说明 |
|---|---|---|
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 潜力,附一句理由与适合做什么。
| 参数 | 类型 | 说明 |
|---|---|---|
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 月起逐月):大盘走势、月榜、单站逐月历史、黑马名单。
| 参数 | 类型 | 说明 |
|---|---|---|
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 天)。
| 参数 | 类型 | 说明 |
|---|---|---|
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"]}'
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)。接入后全部 32 个接口都会作为工具出现,工具描述里带着价格,每次结果末尾注明本次扣了多少积分。
# 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。