# Similarweb

> SimilarWeb 网站分析连接器 — 流量、排名、营销渠道、受众画像等数据

- Skill: `claude-office-skills/similarweb` (Agent Skill)
- Install (CLI): `npx skillmds@latest add claude-office-skills/similarweb`
- Raw SKILL.md: https://api.skillmd.com/api/skills/claude-office-skills/similarweb/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: claude-office-skills (https://skillmd.com/u/claude-office-skills)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/claude-office-skills/similarweb

---


## SimilarWeb 网站分析连接器

通过 `dataBridgePull()` 获取网站流量、排名、营销渠道等分析数据。

### 获取网站流量与互动

```javascript
var resp = dataBridgePull("similarweb", "traffic_engagement", {
  domain: "google.com",
  start_date: "2025-01",
  end_date: "2025-12",
  granularity: "monthly",
  country: "world"
});
if (!resp || !resp.ok) return "获取数据失败: " + (resp ? resp.error : "网络错误");
// resp.data.data 是月度数组，每个元素包含:
//   date, visits, bounce_rate, average_visit_duration, pages_per_visit, unique_visitors
var rows = resp.data.data; // Array: [{date:"2025-01-01", visits:723462947, ...}, ...]
for (var i = 0; i < rows.length; i++) {
  var r = rows[i];
  // r.date (日期), r.visits (访问量), r.bounce_rate (跳出率 0-1),
  // r.average_visit_duration (秒), r.pages_per_visit, r.unique_visitors
}
```

### 获取网站排名

```javascript
var resp = dataBridgePull("similarweb", "website_ranking", {
  domain: "google.com"
});
if (!resp || !resp.ok) return "获取失败: " + (resp ? resp.error : "网络错误");
// resp.data.data 是数组: [{date, rank_global, rank_country, rank_category, ...}]
var rank = resp.data.data[0]; // rank.rank_global, rank.rank_country
```

### 获取流量来源

```javascript
var resp = dataBridgePull("similarweb", "traffic_sources", {
  domain: "google.com",
  start_date: "2025-01",
  end_date: "2025-12",
  country: "world"
});
// 各渠道（直接/搜索/社交/引荐/邮件/展示广告）的流量占比
```

### 获取流量地域分布

```javascript
var resp = dataBridgePull("similarweb", "traffic_geography", {
  domain: "google.com",
  start_date: "2025-01",
  end_date: "2025-12"
});
// 按国家的流量占比
```

### 获取应用详情

```javascript
var resp = dataBridgePull("similarweb", "app_details", {
  app_id: "com.google.android.gm",
  store: "google"
});
```

### 可用 Actions

| Action | 说明 | 必需参数 |
|--------|------|----------|
| `traffic_engagement` | 流量与互动 | domain, start_date, end_date |
| `website_ranking` | 网站排名 | domain |
| `traffic_sources` | 流量来源 | domain, start_date, end_date |
| `traffic_geography` | 流量地域分布 | domain, start_date, end_date |
| `app_details` | 应用详情 | app_id, store |

### 参数说明

| 参数 | 说明 | 示例 |
|------|------|------|
| domain | 网站域名（不含 www） | `"google.com"`, `"baidu.com"` |
| start_date | 开始月份 | `"2024-01"` |
| end_date | 结束月份 | `"2024-12"` |
| granularity | 时间粒度 | `"daily"` / `"weekly"` / `"monthly"` |
| country | 国家/地区 | `"world"`, `"us"`, `"cn"`, `"gb"` |
| store | 应用商店 | `"google"` / `"apple"` |

### 重要规则

- **日期格式 YYYY-MM**：SimilarWeb 使用月份粒度的日期（非 YYYY-MM-DD）
- **日期范围限制**：数据通常只覆盖最近 24 个月（约 2024-02 到 2026-02）。推荐使用 `start_date: "2025-01"`, `end_date: "2025-12"` 或 `"2026-01"` 等近期日期。**不要用超出范围的日期**。
- **国家小写**：使用小写国家代码（`"us"` 而非 `"US"`），或 `"world"` 表示全球
- **域名不含协议**：传入 `"google.com"` 而非 `"https://www.google.com"`
- **检查 `resp.ok`**：必须检查返回状态
- **API 限流**：每秒最多 10 次请求，系统已内置缓存（1 小时 TTL）
- **⚠️ 单次代码块最多查询 3 个域名**：每个 API 调用是同步阻塞的（5-15 秒/次），超过 3 个域名会导致执行超时。多域名研究应**分批执行**（第一批 3 个 → 写入表格 → 第二批 3 个）。
- **仅使用 `traffic_engagement` 和 `website_ranking` action**：`traffic_sources` 和 `traffic_geography` 在当前 API 计划下不可用（返回 404）。不要使用它们。