similarweb-traffic

SimilarWeb 流量

获取任意域名的流量概览估算值，包括月访问量、流量来源细分、热门国家、热门关键词、互动指标以及全球排名和类别排名。

何时使用此技能

在用户遇到以下情况时使用此技能：

• 询问某个域名的流量（“X 的流量是多少？”）
• 想了解某个网站的月访问量趋势
• 需要查看流量来源细分（自然流量、直接流量、付费流量、GenAI 等）
• 想了解某个网站的受众来自哪些国家
• 想比较或对标多个域名或竞争对手

用法

无需 API 密钥。独立的 Node 脚本（使用内置的 fetch，无需运行 npm install）。

node scripts/fetch-similarweb-traffic.js <domain>

示例：

# Formatted markdown summary (default)
node scripts/fetch-similarweb-traffic.js chatslide.ai

# Raw normalized JSON (for further processing / comparisons)
node scripts/fetch-similarweb-traffic.js stripe.com --json

域名可以直接传入（example.com），也可以传入 URL（https://www.example.com/pricing）——脚本会对其进行规范化处理（去除协议、www. 和路径）。

比较多个域名

对每个域名分别运行一次脚本并使用 --json，然后将结果合并到表格中。为避免给接口造成负担，请在调用之间稍作延迟。

输出

默认模式会打印 Markdown 摘要：包含指标的表格（月访问量、排名、跳出率、每次访问页数、网站停留时间）、月访问量趋势线、流量来源细分、热门国家和热门关键词。

--json 模式会打印规范化的对象：

{
  "domain": "stripe.com",
  "globalRank": 327,
  "categoryRank": 21,
  "category": "Finance",
  "snapshotMonth": "2026-05",
  "visits": 122394040,
  "bounceRate": 0.55,
  "pagesPerVisit": 3.26,
  "timeOnSite": 165.9,
  "estimatedMonthlyVisits": [{ "date": "2026-03-01", "visits": 118067753 }],
  "trafficSources": { "searchOrganic": 0.48, "direct": 0.23, "...": 0 },
  "topCountries": [{ "countryCode": "US", "value": 0.087 }],
  "topKeywords": ["..."]
}

visits 表示最近一个完整月份的数据。比率（bounceRate、所有 trafficSources、topCountries[].value）均为 0–1 的小数。

API 详情

• 接口：https://data.similarweb.com/api/v1/data?domain=<domain> — SimilarWeb 的未公开公共数据接口（其浏览器扩展使用的接口）。无需身份验证、无需密钥，且免费。
• 需要浏览器的 user-agent 标头（脚本会发送）——默认的 curl/机器人 User-Agent 会被拦截。
• 同步调用，会立即返回。

重要说明

• 这是估算值，并非真实数据。 SimilarWeb 会对流量进行建模；数据可能有误，尤其是中低流量网站。对于你拥有的域名，你自己的 Google Analytics / Search Console 数据才是权威数据——如果有这些数据，请优先使用。
• 未知域名返回零值，而非错误。 如果 SimilarWeb 没有某个域名的数据，它会返回 HTTP 200，并提供全为零值或合成数据的结果。如果所有访问量均为 0，应将其视为“没有 SimilarWeb 数据”。
• 非官方接口。 它可能会被限流、改变返回格式，或在不另行通知的情况下要求身份验证；在 SimilarWeb 的付费 API 之外使用其数据属于灰色地带。
• 退出码：2 表示网络错误，3 表示非 200 HTTP 响应。