OPEN API × MCP × CLI × SKILLS

哥飞 SEO 工具箱 · 开放 API

本站每个工具背后的数据与分析管线，都可以在你自己的脚本、AI 客户端与自动化流程里直接调用：16 个组装接口（关键词难度、SERP 解密、网站估值、外链评估、页面体检……拿到的是结论）+ 16 个原始数据接口（谷歌搜索结果、DR、网站流量、搜索量、拓词、站点出词、域名注册状态……拿到的是料）+ 4 个方法论与知识库接口（哥飞 SEO Agent 的专题手册、哥飞知识库）——让你自己的 AI 按哥飞的方法查、按哥飞的口径答。

HTTP API任何语言的脚本与自动化，JSON 进 JSON 出 MCPClaude、Cursor 等 AI 客户端直接当工具调用 命令行一个零依赖 Node 脚本，终端里一行一个查询 Claude Skills装进 Claude，它自己知道什么时候查什么

1. 获取令牌

用 Web.Cafe 账号登录后生成令牌（wc_mcp_ 开头），每个令牌都通用于 HTTP API、MCP、命令行与 Skills。一个账号最多 10 个，建议每个地方单独一个（比如「Claude Code 笔记本」「选词脚本」）：扣费明细里会写是哪个令牌花的，哪个泄露了就单删哪个，不影响别的。明文只显示一次，服务端只存哈希。

正在检测登录状态…

2. 积分与扣费明细

以下积分计费规则仅适用于 SEO 工具。

只扣积分余额：接口调用从你的积分余额里扣。在积分中心购买的积分、邀请好友得到的奖励积分，网站与 API 通用；每日赠送的额度仅限在本站网页里使用，API 不会扣这部分，也用不了。
每次调用都有明细：每一次调用都会在积分中心的「积分变动明细」里单独记一行，写明接口名、调用入口（API / MCP / 命令行 / Skills）、查了什么和请求号；也可以用 GET /api/v1/usage 拉取明细自动对账。
响应里写明本次扣费：JSON 里的 credits.charged 与响应头 X-Credits-Charged 是本次实际扣的积分，X-Request-Id 与明细里的请求号一一对应。
失败自动退回：参数错误在扣费前就拒绝；上游故障、零产出的调用自动退回积分，明细里单独记一行「失败退回」。按返回条数计价的接口先按起步价预扣，跑完按实际多退少补；预扣前会先确认你的积分够这次调用最多可能花的数。
个别接口会员与非会员价格不同：目前是谷歌趋势两个接口（google_trends、trends_rising）。目录里写的是会员价；非会员扣的积分数少一些，但非会员的积分买得贵（积分包 1 元 10 分起，会员 1 元 40 分起），折成钱非会员花得更多——同样实时抓取一次，会员约 ¥0.10，非会员约 ¥0.20，折成钱会员仍然只要非会员的一半左右。按调用那一刻的身份算，会员过期后按非会员价；接入 MCP 后工具列表里显示的就是你自己身份的价格。其它接口不分身份。
限速：每个账户每分钟有调用次数上限（工具接口每分钟 10 次；数据服务接口共享每分钟 120 次，互不占用），超出返回 429，按响应头 Retry-After 等几秒即可。

价格见下方接口目录（「积分/次」为单次调用的价格）。查看余额：GET /api/v1/me；成功调用会在 credits 里返回本次扣费 charged 与剩余 balance（快见底时带 low）。积分不够时接口返回 402 与 code: "quota"（不扣费），到积分中心购买即可；余额够、但当天已到每日上限时返回 429 与 code: "day_cap"，北京时间早上 8 点清零。

3. 接口目录

数据服务

数据访问权限以 new.web.cafe 为准，API 查询不额外扣除 SEO 积分。购买与权限说明。

完整参数、响应字段及错误定义，请参阅 OpenAPI 3.1 接口规范。

新词发现服务

网页版：新词发现服务。

GET /api/v1/keywords/batches批次列表不额外扣除 SEO 积分，需购买数据权限

查询当前账户有权访问的批次，按完成时间倒序返回，每页最多 30 个批次。

参数	类型	说明
`page`	integer	页码，可选，默认 1，最小值 1。响应 `data.has_more` 表示是否存在下一页；超出末页返回空列表。

curl "https://seo.web.cafe/api/v1/keywords/batches?page=1" \
  -H "Authorization: Bearer $WEBCAFE_TOKEN"

GET /api/v1/keywords/batches/{id}批次全部关键词不额外扣除 SEO 积分，需购买数据权限

返回指定批次当前保存的全部关键词及分析数据，不分页。批次内容和分析资料可能更新，响应允许缓存 1 小时。

参数	类型	说明
`id` 必填	string	批次 ID，路径参数，取批次列表响应中的 `id`

curl "https://seo.web.cafe/api/v1/keywords/batches/2026-10-12T0851" \
  -H "Authorization: Bearer $WEBCAFE_TOKEN"

GET /api/v1/keywords关键词搜索不额外扣除 SEO 积分，需购买数据权限

搜索已授权关键词，默认按热度降序，每页 30 条。

参数	类型	说明
`q`	string	关键词，最多 60 字符；留空不筛选。
`tab`	string	分类。new：新词；resurgence：二次爆火；evergreen：长期大词；game：游戏；all：全部（排除不值得做）；skip：不值得做。默认不筛选，包含不值得做。
`page`	integer	页码，默认 1；超出末页返回空列表。

返回内容：关键词、热度、趋势、判断理由、简述、详情地址及分页信息。

curl "https://seo.web.cafe/api/v1/keywords?q=video&tab=new&page=1" \
  -H "Authorization: Bearer $WEBCAFE_TOKEN"

响应示例（示例数据）

{
  "ok": true,
  "credits": {
    "charged": 0
  },
  "data": {
    "items": [
      {
        "keyword": "example video maker",
        "category": "",
        "kind": "new",
        "trend_now": "",
        "heat_ratio": 65,
        "growth_pct": null,
        "appear_date": "2026-11-09",
        "burst_date": null,
        "pushed_on": null,
        "page_count": 0,
        "targeted_count": 0,
        "verdict": "worth",
        "verdict_reasons": [],
        "verdict_suggestion": "",
        "brief": {
          "what": "video",
          "want": "edit",
          "how": "build"
        },
        "sources": [],
        "spark": [
          1,
          0,
          2
        ],
        "page_url": "https://new.web.cafe/keywords/example-video-maker",
        "slug": "example-video-maker",
        "detail_api_url": "/api/v1/keywords/word/example-video-maker"
      }
    ],
    "page": 1,
    "page_size": 30,
    "total": 1,
    "has_more": false
  },
  "requestId": "req_00000000000000000000000000000000",
  "meta": {
    "reason": "ok",
    "message": "查询成功。"
  }
}

GET /api/v1/keywords/word/{slug}关键词详情不额外扣除 SEO 积分，需购买数据权限

获取已授权关键词的详情。

参数	类型	说明
`slug` 必填	string	关键词标识，取搜索结果的 slug。

返回内容：基础资料、分析、日周趋势、搜索结果及关联词。衍生词每类最多 200 条，来源词和同义词各最多 40 条。

curl "https://seo.web.cafe/api/v1/keywords/word/example-video-maker" \
  -H "Authorization: Bearer $WEBCAFE_TOKEN"

响应示例（示例数据）

{
  "ok": true,
  "credits": {
    "charged": 0
  },
  "data": {
    "word": {
      "keyword": "example video maker",
      "category": "",
      "kind": "new",
      "trend_now": "",
      "heat_ratio": 65,
      "growth_pct": null,
      "appear_date": "2026-11-09",
      "burst_date": null,
      "pushed_on": null,
      "page_count": 0,
      "targeted_count": 0,
      "verdict": "worth",
      "verdict_reasons": [],
      "verdict_suggestion": "",
      "brief": {
        "what": "video",
        "want": "edit",
        "how": "build"
      },
      "sources": [],
      "spark": [
        1,
        0,
        2
      ],
      "page_url": "https://new.web.cafe/keywords/example-video-maker",
      "slug": "example-video-maker",
      "core_key": "video",
      "notes": "",
      "serp": null,
      "serp_pages": null,
      "daily_from": null,
      "weekly_from": null,
      "serp_on": null,
      "serp_pages_on": null,
      "heat_on": null,
      "appear_precision": "",
      "peak_date": null,
      "first_seen_on": "2026-10-15",
      "last_seen_on": "2026-11-09",
      "checked_on": null,
      "is_game": false,
      "new_site_count": 0,
      "daily": [
        1,
        0,
        2
      ],
      "weekly": [
        3,
        4
      ]
    },
    "children": [
      {
        "keyword": "free relation",
        "rel": "rising",
        "best_rise": null,
        "best_label": "",
        "best_rank": null,
        "seen_days": 1,
        "first_seen_on": "2026-10-01",
        "last_seen_on": "2026-11-09",
        "slug": null,
        "heat_ratio": null,
        "kind": null,
        "trend_now": null,
        "appear_date": null
      }
    ],
    "parents": [],
    "synonyms": [
      {
        "keyword": "50%_off",
        "slug": "literal",
        "heat_ratio": 0,
        "kind": ""
      }
    ]
  },
  "requestId": "req_00000000000000000000000000000000",
  "meta": {
    "reason": "ok",
    "message": "查询成功。"
  }
}

新站发现服务

网页版：新站发现服务。

GET /api/v1/launches/batches批次列表不额外扣除 SEO 积分，需购买数据权限

查询当前账户有权访问的新站批次，按完成时间倒序返回，每页最多 30 个批次。

参数	类型	说明
`page`	integer	页码，可选，默认 1，最小值 1。响应 `data.has_more` 表示是否存在下一页；超出末页返回空列表。

curl "https://seo.web.cafe/api/v1/launches/batches?page=1" \
  -H "Authorization: Bearer $WEBCAFE_TOKEN"

GET /api/v1/launches/batches/{id}批次全部项目不额外扣除 SEO 积分，需购买数据权限

返回指定批次的全部项目及已有分析数据，包含网站、应用和开源仓库。包含未分析项目。按原帖发布时间倒序返回，不分页。

参数	类型	说明
`id` 必填	string	批次 ID，路径参数，取批次列表响应中的 `id`。

curl "https://seo.web.cafe/api/v1/launches/batches/2026-10-14T0054" \
  -H "Authorization: Bearer $WEBCAFE_TOKEN"

GET /api/v1/launches新站搜索不额外扣除 SEO 积分，需购买数据权限

搜索 Hacker News 和 X 的已授权项目，按发布时间降序，每页 30 条。

参数	类型	说明
`q`	string	搜索标题、域名、用途或目标关键词，最多 60 字符；留空不筛选。
`type`	string	类型，默认 site。site：网站和应用；repo：开源仓库；all：全部。
`motive`	string	开发动机，默认不筛选。keyword：关键词需求；own_need：自身需求；others_need：他人需求；hobby：兴趣；business：商业机会；unknown：未说明。
`page`	integer	页码，默认 1；超出末页返回空列表。

返回内容：项目资料、流量、用途、受众、开发动机、变现方式及分页信息。

curl "https://seo.web.cafe/api/v1/launches?q=video&type=site&motive=keyword&page=1" \
  -H "Authorization: Bearer $WEBCAFE_TOKEN"

响应示例（示例数据）

{
  "ok": true,
  "credits": {
    "charged": 0
  },
  "data": {
    "items": [
      {
        "source": "x",
        "source_url": "https://x.com/example/status/65",
        "title": "Example Video",
        "url": null,
        "domain": "video.example",
        "link_type": "site",
        "posted_at": "2026-10-15T00:00:00.000Z",
        "score": 0,
        "comment_count": 0,
        "domain_registered": null,
        "monthly_traffic": null,
        "analyzed": true,
        "purpose": "Video maker",
        "audience": null,
        "category": null,
        "motive_type": "keyword",
        "motive_stated": false,
        "motive": null,
        "motive_evidence": null,
        "keyword": null,
        "keyword_domain": null,
        "monetization": null
      }
    ],
    "page": 1,
    "page_size": 30,
    "total": 1,
    "has_more": false
  },
  "requestId": "req_00000000000000000000000000000000",
  "meta": {
    "reason": "ok",
    "message": "查询成功。"
  }
}

网站发现服务

网页版：网站发现服务。

GET /api/v1/hosted/batches批次列表不额外扣除 SEO 积分，需购买数据权限

查询当前账户有权访问的网站发现批次，按完成时间倒序返回，每页最多 30 个批次。

参数	类型	说明
`page`	integer	页码，可选，默认 1，最小值 1。响应 `data.has_more` 表示是否存在下一页；超出末页返回空列表。

curl "https://seo.web.cafe/api/v1/hosted/batches?page=1" \
  -H "Authorization: Bearer $WEBCAFE_TOKEN"

GET /api/v1/hosted/batches/{id}批次网站和关键词不额外扣除 SEO 积分，需购买数据权限

返回指定批次已授权的网站、关键词及当前资料，不分页，不使用 page。省略 28d 时返回已授权的月度数据及最新 28d；指定日期时仅查询该日采集的滚动 28 天快照，不是当天数据。

参数	类型	说明
`id` 必填	string	批次 ID，路径参数，取批次列表响应中的 `id`。
`28d`	string	可选，快照采集日期，格式 YYYY-MM-DD。取自默认详情的 `data.reports_28d[].date_28d`，须属于该批次且已获授权。

# 批次成员的已授权当前资料
curl "https://seo.web.cafe/api/v1/hosted/batches/2026-10-15T0252" \
  -H "Authorization: Bearer $WEBCAFE_TOKEN"

# 指定采集日期的 28d 快照；日期取自该批次的 reports_28d
curl "https://seo.web.cafe/api/v1/hosted/batches/2026-10-15T0252?28d=2026-10-15" \
  -H "Authorization: Bearer $WEBCAFE_TOKEN"

日期不属于该批次时返回 404/report_28d_not_found；未解锁时返回 403/data_locked。

GET /api/v1/hosted/sites网站搜索不额外扣除 SEO 积分，需购买数据权限

搜索各托管平台的已授权网站，按首次收录日期降序，每页 50 条。

参数	类型	说明
`q`	string	搜索网站地址或主要关键词，最多 60 字符；留空不筛选。
`generic`	integer	默认 0。0：全部；1：仅通用词，排除品牌词和导航词。
`page`	integer	页码，默认 1；超出末页返回空列表。

返回内容：网站、主要关键词、搜索点击量、详情地址及分页信息；含最近 12 个月和最新近 28 天的已授权数据。

curl "https://seo.web.cafe/api/v1/hosted/sites?q=video&generic=1&page=1" \
  -H "Authorization: Bearer $WEBCAFE_TOKEN"

响应示例（示例数据）

{
  "ok": true,
  "credits": {
    "charged": 0
  },
  "data": {
    "items": [
      {
        "site": "example.pages.dev",
        "brand": false,
        "pages": 1,
        "title": "",
        "months": 1,
        "platform": "pages.dev",
        "first_seen": "2026-10-01",
        "description": "",
        "peak_clicks": 65,
        "first_period": "2026-10",
        "top_keywords": [
          {
            "kw": "video maker",
            "clicks": 65
          }
        ],
        "months_clicks": {
          "2026-10": 65
        },
        "latest28_clicks": null,
        "detail_api_url": "/api/v1/hosted/site?site=example.pages.dev",
        "page_url": "https://new.web.cafe/hosted/site?s=example.pages.dev"
      }
    ],
    "page": 1,
    "page_size": 50,
    "total": 1,
    "has_more": false,
    "periods": [
      {
        "period": "2026-10",
        "as_of": null,
        "captured_on": null,
        "platforms": [
          "pages.dev"
        ]
      }
    ]
  },
  "requestId": "req_00000000000000000000000000000000",
  "meta": {
    "reason": "ok",
    "message": "查询成功。"
  }
}

GET /api/v1/hosted/site网站详情不额外扣除 SEO 积分，需购买数据权限

获取已授权网站的搜索表现和页面明细。

参数	类型	说明
`site` 必填	string	网站标识，取搜索结果的 site。

返回内容：网站资料、主要关键词、搜索点击量及页面明细，最多 200 个页面。

curl "https://seo.web.cafe/api/v1/hosted/site?site=example.pages.dev" \
  -H "Authorization: Bearer $WEBCAFE_TOKEN"

响应示例（示例数据）

{
  "ok": true,
  "credits": {
    "charged": 0
  },
  "data": {
    "info": {
      "site": "example.pages.dev",
      "platform": "pages.dev",
      "months_clicks": {
        "2026-10": 65
      },
      "first_period": "2026-10",
      "first_seen": "2026-10-01",
      "months": 1,
      "peak_clicks": 65,
      "latest28_clicks": null,
      "top_keywords": [
        {
          "kw": "video maker",
          "clicks": 65
        }
      ],
      "brand": false,
      "pages": 1,
      "title": "",
      "description": "",
      "detail_api_url": "/api/v1/hosted/site?site=example.pages.dev",
      "page_url": "https://new.web.cafe/hosted/site?s=example.pages.dev"
    },
    "periods": [
      {
        "period": "2026-10",
        "as_of": null,
        "captured_on": null,
        "platforms": [
          "pages.dev"
        ]
      }
    ],
    "pages": [
      {
        "url": "https://example.pages.dev/a",
        "top_keyword": "video maker",
        "keywords": 2,
        "months_clicks": {
          "2026-10": 65
        }
      }
    ]
  },
  "requestId": "req_00000000000000000000000000000000",
  "meta": {
    "reason": "ok",
    "message": "查询成功。"
  }
}

GET /api/v1/hosted/keyword网站发现关键词详情不额外扣除 SEO 积分，需购买数据权限

获取关键词的搜索点击量及关联网站。

参数	类型	说明
`keyword` 必填	string	关键词，取网站主要关键词或批次关键词列表。

返回内容：关键词点击量、网站数量及各站点击量，最多 200 个网站。

curl "https://seo.web.cafe/api/v1/hosted/keyword?keyword=video+maker" \
  -H "Authorization: Bearer $WEBCAFE_TOKEN"

响应示例（示例数据）

{
  "ok": true,
  "credits": {
    "charged": 0
  },
  "data": {
    "info": {
      "kw": "video maker",
      "months_clicks": {
        "2026-10": 65
      },
      "months_sites": {
        "2026-10": 1
      },
      "sites": 1,
      "first_period": "2026-10",
      "first_seen": "2026-10-01",
      "peak_clicks": 65,
      "latest28_clicks": null,
      "top_sites": [
        {
          "site": "example.pages.dev",
          "clicks": 65
        }
      ],
      "detail_api_url": "/api/v1/hosted/keyword?keyword=video%20maker",
      "page_url": "https://new.web.cafe/hosted/keyword?k=video%20maker"
    },
    "periods": [
      {
        "period": "2026-10",
        "as_of": null,
        "captured_on": null,
        "platforms": [
          "pages.dev"
        ]
      }
    ],
    "sites": [
      {
        "site": "example.pages.dev",
        "platform": "pages.dev",
        "months_clicks": {
          "2026-10": 65
        },
        "detail_api_url": "/api/v1/hosted/site?site=example.pages.dev"
      }
    ]
  },
  "requestId": "req_00000000000000000000000000000000",
  "meta": {
    "reason": "ok",
    "message": "查询成功。"
  }
}

收入数据服务

网页版：收入数据服务。

收入 API v1 已停用，返回 410/api_retired。请使用以下 v2 接口。

流量为估算值，不代表实际营收。

GET /api/v2/checkouts/months报告月份列表不额外扣除 SEO 积分，需购买数据权限

查询可读取的月份和快照日期，按月份倒序返回，每页最多 30 个月。递增 page，直至 data.has_more=false；超出末页返回空列表。

参数	类型	说明
`page`	integer	页码，可选，默认 1，最小值 1。

curl "https://seo.web.cafe/api/v2/checkouts/months" \
  -H "Authorization: Bearer $WEBCAFE_TOKEN"

响应示例（示例数据）

{
  "ok": true,
  "credits": {
    "charged": 0
  },
  "data": {
    "months": [
      {
        "month": "2026-09",
        "has_monthly": true,
        "dates_28d": [
          "2026-09-30"
        ]
      }
    ],
    "has_more": false
  },
  "requestId": "req_00000000000000000000000000000000",
  "meta": {
    "reason": "ok",
    "message": "查询成功。"
  }
}

GET /api/v2/checkouts/months/{month}月份报告及网站流量不额外扣除 SEO 积分，需购买数据权限

默认查询整月报告的渠道汇总与网站流量，每页最多 50 个网站。递增 page，直至 data.has_more=false。

参数	类型	说明
`month` 必填	string	报告月份，路径参数，格式 YYYY-MM。
`28d`	string	可选，该月内快照采集日期，格式 YYYY-MM-DD。查询滚动 28 天数据，不是当天流量。
`page`	integer	页码，可选，默认 1，最小值 1。

# 整月报告，第 1 页（page 默认值为 1）
curl "https://seo.web.cafe/api/v2/checkouts/months/2026-09" \
  -H "Authorization: Bearer $WEBCAFE_TOKEN"

# 整月报告，第 2 页
curl "https://seo.web.cafe/api/v2/checkouts/months/2026-09?page=2" \
  -H "Authorization: Bearer $WEBCAFE_TOKEN"

# 指定采集日期的 28d 快照，第 1 页；日期取自目录的 dates_28d
curl "https://seo.web.cafe/api/v2/checkouts/months/2026-09?28d=2026-09-30&page=1" \
  -H "Authorization: Bearer $WEBCAFE_TOKEN"

channels 为完整报告合计，不应跨页相加。无报告返回 404/report_not_found。多次请求之间报告可能更新，不提供跨页固定快照。

响应示例（示例数据）

{
  "ok": true,
  "credits": {
    "charged": 0
  },
  "data": {
    "channels": [
      {
        "host": "buy.stripe.com",
        "channel": "stripe",
        "direction": "in",
        "periods": {
          "2026-09": {
            "total_visits": 12000,
            "site_count": 80
          }
        }
      }
    ],
    "sites": [
      {
        "domain": "example.com",
        "first_period": "2026-08",
        "channels": [
          "stripe"
        ],
        "global_rank": null,
        "category": null,
        "traffic": [
          {
            "host": "buy.stripe.com",
            "direction": "in",
            "months_visits": {
              "2026-09": 120
            },
            "shares": {
              "2026-09": 0.01
            },
            "children": []
          }
        ],
        "page_url": "https://new.web.cafe/checkouts/site?d=example.com&month=2026-09"
      }
    ],
    "page": 1,
    "page_size": 50,
    "has_more": false
  },
  "requestId": "req_00000000000000000000000000000000",
  "meta": {
    "reason": "ok",
    "message": "查询成功。"
  }
}

GET /api/v2/checkouts/sites收入网站搜索不额外扣除 SEO 积分，需购买数据权限

搜索从支付渠道获得流量的已授权网站，覆盖全部渠道，排除全球排名前 5000。按首次收录月份降序，每页 50 条。

参数	类型	说明
`q`	string	域名或域名片段，最多 60 字符；留空不筛选。
`page`	integer	页码，默认 1；超出末页返回空列表。

返回内容：网站、排名、支付渠道、访问量、详情地址及分页信息；含最近 15 个月和最新近 28 天的已授权数据。

curl "https://seo.web.cafe/api/v2/checkouts/sites?q=example&page=1" \
  -H "Authorization: Bearer $WEBCAFE_TOKEN"

响应示例（示例数据）

{
  "ok": true,
  "credits": {
    "charged": 0
  },
  "data": {
    "items": [
      {
        "domain": "example.com",
        "category": "",
        "channels": [
          "stripe"
        ],
        "first_seen": "2026-10-01",
        "global_rank": 10000,
        "peak_visits": 66,
        "first_period": "2026-10",
        "months_count": 1,
        "latest_visits": null,
        "months_visits": {
          "2026-10": 66
        },
        "direction": "out",
        "detail_api_url": "/api/v2/checkouts/site?domain=example.com",
        "page_url": "https://new.web.cafe/checkouts/site?d=example.com"
      }
    ],
    "page": 1,
    "page_size": 50,
    "total": 1,
    "has_more": false,
    "periods": [
      {
        "host": "buy.stripe.com",
        "channel": "stripe",
        "direction": "out",
        "period": "2026-10",
        "date_28d": null,
        "source_period": null
      }
    ]
  },
  "requestId": "req_00000000000000000000000000000000",
  "meta": {
    "reason": "ok",
    "message": "查询成功。"
  }
}

GET /api/v2/checkouts/site收入网站详情不额外扣除 SEO 积分，需购买数据权限

获取网站与支付渠道的已授权流量。out：渠道 → 网站；in：网站 → 渠道。访问量不代表营收。

参数	类型	说明
`domain` 必填	string	网站域名，取搜索结果的 domain。

返回内容：网站资料、双向访问量、渠道占比、子站明细及历史趋势。趋势中的每个日期代表近 28 天访问量，并非单日流量。

curl "https://seo.web.cafe/api/v2/checkouts/site?domain=example.com" \
  -H "Authorization: Bearer $WEBCAFE_TOKEN"

响应示例（示例数据）

{
  "ok": true,
  "credits": {
    "charged": 0
  },
  "data": {
    "domain": "example.com",
    "global_rank": 10000,
    "category": "",
    "profiles": {
      "out": {
        "domain": "example.com",
        "channels": [
          "stripe"
        ],
        "first_period": "2026-10",
        "first_seen": "2026-10-01",
        "months_count": 1,
        "peak_visits": 66,
        "latest_visits": null,
        "global_rank": 10000,
        "category": "",
        "months_visits": {
          "2026-10": 66
        },
        "direction": "out",
        "detail_api_url": "/api/v2/checkouts/site?domain=example.com",
        "page_url": "https://new.web.cafe/checkouts/site?d=example.com"
      },
      "in": null
    },
    "traffic": [
      {
        "host": "buy.stripe.com",
        "direction": "out",
        "shares": {
          "2026-10": 0
        },
        "months_visits": {
          "2026-10": 66
        },
        "children": [
          {
            "domain": "sub.example",
            "visits": 0,
            "share": 0,
            "is_new": false
          }
        ],
        "children_period": "2026-10"
      }
    ],
    "periods": [
      {
        "host": "buy.stripe.com",
        "channel": "stripe",
        "direction": "out",
        "period": "2026-10",
        "date_28d": null,
        "source_period": null
      }
    ],
    "page_url": "https://new.web.cafe/checkouts/site?d=example.com",
    "history_month": "2026-10",
    "history": [
      {
        "host": "buy.stripe.com",
        "direction": "out",
        "shares": {
          "2026-10-15": 0
        },
        "months_visits": {
          "2026-10-15": 200
        },
        "children": [],
        "children_period": "2026-10-15"
      }
    ],
    "history_periods": [
      {
        "host": "buy.stripe.com",
        "channel": "stripe",
        "direction": "out",
        "period": "2026-10-15",
        "date_28d": "2026-10-15",
        "source_period": {}
      }
    ]
  },
  "requestId": "req_00000000000000000000000000000000",
  "meta": {
    "reason": "ok",
    "message": "查询成功。"
  }
}

哥飞组装（16 个）

站内工具的完整分析管线，与网页上看到的结果同一套算法、同一份缓存。

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
`refresh`	boolean	获取新搜索结果并重新计算；同词、国家、语言共享 6 小时间隔
`force`	boolean	refresh 的兼容别名，默认 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}'

方法论与知识库（4 个）

站内哥飞 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":"新站多久开始做外链"}'

原始数据（16 个）

未经加工的一手数据，适合自己建模、批量入库或喂给自己的 Agent。

serp谷歌搜索结果2 积分/次

谷歌实时搜索结果原始数据：自然结果（含 sitelinks）、相关搜索、People Also Ask、知识面板等（7 天缓存）。

参数	类型	说明
`q` 必填	string	搜索词（≤200 字符）
`gl`	string	Google 国家代码，默认 us（可选 gb/ca/au/de/jp/sg 等）
`hl`	string	语言代码，默认 en
`refresh`	boolean	获取新搜索结果；同词、国家、语言共享 6 小时间隔

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"]}'

lookup_keywords关键词库存数据每 50 个关键词 1.5 积分（合计向上取整，最低 1 积分）

按关键词精确读本站已存的数据：搜索量、逐月、CPC、意图、预筛难度、哥飞版 KD，每项带入库日期。只读库、不实时查询，库里没有的词返回 found=false。

参数	类型	说明
`keywords` 必填	array	关键词数组，1~100 个（精确匹配，不分大小写）
`gl`	string	Google 国家代码，默认 us（可选 gb/ca/au/de/jp/sg 等）
`hl`	string	语言，默认 en

curl -X POST https://seo.web.cafe/api/v1/lookup_keywords \
  -H "Authorization: Bearer $WEBCAFE_TOKEN" -H "Content-Type: application/json" \
  -d '{"keywords":["ai image generator","pdf to word"]}'

lookup_domains域名库存数据每 50 个域名 1.5 积分（合计向上取整，最低 1 积分）

按域名精确读本站已存的数据：月访问量、逐月访问、DR、注册与到期日期、自然搜索流量快照，每项带入库日期。只读库、不实时查询，库里没有的域名返回 found=false。

参数	类型	说明
`domains` 必填	array	域名数组，1~100 个
`gl`	string	Google 国家代码，默认 us（可选 gb/ca/au/de/jp/sg 等）
`hl`	string	自然流量快照的语言，默认 en

curl -X POST https://seo.web.cafe/api/v1/lookup_domains \
  -H "Authorization: Bearer $WEBCAFE_TOKEN" -H "Content-Type: application/json" \
  -d '{"domains":["canva.com"]}'

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 等）。

4. HTTP API

数据服务使用接口目录标注的请求方法。
地址：https://seo.web.cafe/api/v1/<接口>，POST JSON 请求体，或 GET 查询参数（数组用逗号分隔）
鉴权：请求头 Authorization: Bearer 你的令牌（不方便加请求头时可用 ?token=）
支持跨域（CORS），浏览器插件与书签脚本可直接调用

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"

5. MCP（AI 客户端）

MCP 地址：https://seo.web.cafe/api/mcp（Streamable HTTP）。接入后可调用接口目录中的工具。SEO 工具描述包含价格，调用结果注明本次扣除的积分。

# 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 继续可用，同样能看到全部工具。

用你自己的 AI 当「哥飞 SEO Agent」

站内的哥飞 SEO Agent = 大模型 + 哥飞的方法论 + 这些工具 + 哥飞知识库。接入 MCP 之后，模型换成你自己的 Claude，其余几样照样都在：

总纲：MCP 握手时自动下发工作方式（数字只认工具结果、先取手册、怎么省积分、选词口径），Claude Code 等客户端连上就会读到。
手册：load_guide 按问题取选词 / 新词 / 域名 / 流量 / 归因 / 外链等专题手册，和站内 Agent 用的是同一套。
知识库：knowledge_search 找哥飞说过什么，knowledge_read 带着问题读相关段落。
工作流模板（MCP prompts）：「哥飞 SEO 顾问」「选词」「拆竞品」「买域名尽调」「优化页面」。在 Claude Code 里是 /mcp__gefei__keywords 这样的斜杠命令，Claude Desktop 在输入框的「+」里选；装了下面的 Skills 更顺手，直接 /gefei-keywords。

自己写程序调 Claude / OpenAI 的，用 GET /api/v1/agent-kit（加 ?format=openai 给 OpenAI 格式）一次拿到 system 提示词和全部工具定义，放进你的工具调用循环；模型要调哪个工具，就把参数 POST 到 /api/v1/<工具名>，把响应里的 markdown（没有就用 data）交回给模型。大模型费用在你那边，我们只按工具调用扣积分。

6. 命令行

一个零依赖的 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 扣费明细

7. Claude Skills

把工具箱装成 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。