SimilarWeb 集成实战指南:在 marketingskills 中用 REST API 与零依赖 CLI 完成竞品流量情报分析
AI 技能人工智能【免费下载链接】marketingskillsMarketing skills for Claude Code and AI agents. CRO, copywriting, SEO, analytics, and growth engineering.项目地址https://gitcode.com/GitHub_Trending/mar/marketingskills点击查看免费下载本指南系统讲解如何在 AI Agent 工作流中集成 SimilarWeb——面向网站流量情报的竞争情报平台覆盖 API 能力边界、认证方式、12 个核心数据端点的调用方法与返回字段解析并深入剖析仓库自带的零依赖 CLIsimilarweb.js的底层实现让 Agent 可以直接完成竞品流量趋势、流量来源构成、有机/付费关键词、相似站点与地理分布等分析任务。读完本文你将掌握在 Claude Code 等 Agent 环境中直接调用 SimilarWeb 数据、并与seo-audit、competitors、ads、content-strategy等营销技能联动完成竞品对标与市场调研的完整方案。SimilarWeb 集成能力总览SimilarWeb 是竞争性流量情报平台核心价值在于提供任意网站的访问量分析website analytics、流量来源构成traffic sources、关键词数据keyword data与竞品洞察competitor insights。在 marketingskills 仓库的 工具注册表 中它被归入Competitive Intelligence竞争情报类别定位为网站流量、竞品分析的首选工具官方推荐语为Similarweb for competitor traffic analysis and market benchmarking用于竞品流量分析与市场基准对标。仓库对该集成的支持能力矩阵如下出自 集成指南集成方式可用性说明API✓Traffic、Search、Referrals、Competitors、Geography 五类数据MCP-暂不可用无原生 MCP ServerCLI✓仓库自带 similarweb.js 零依赖命令行工具SDK-仅 REST API无官方 SDK关键结论SimilarWeb 仅提供 REST API仓库通过自研 CLI 弥补了 Agent 场景下的调用缺口由于无 MCP 支持Agent 集成时优先走 CLI 或直接构造 HTTP 请求。认证方式API Key 查询参数SimilarWeb 使用最简单的认证方式——API Key作为查询参数直接附加在请求 URL 上类型API Key传递方式查询参数?api_key{key}获取位置SimilarWeb 账户后台的 Account Settings API 页面在仓库的 CLI 实现 similarweb.js 中API Key 通过环境变量SIMILARWEB_API_KEY读取未设置时立即报错退出const API_KEY process.env.SIMILARWEB_API_KEY const BASE_URL https://api.similarweb.com/v1 if (!API_KEY) { console.error(JSON.stringify({ error: SIMILARWEB_API_KEY environment variable required })) process.exit(1) }这与 CLI 使用说明 中所有营销 CLI 的统一安全规范一致凭据只从环境变量读取绝不硬编码在脚本中。推荐的密钥管理方式是写入 shell 配置文件~/.bashrc或.env文件该文件已被仓库 gitignore。请求 URL 的拼接逻辑在api()函数中完成自动处理路径中是否已带查询参数的情况const separator path.includes(?) ? : ? const url ${BASE_URL}${path}${separator}api_key${API_KEY}也就是说无论你调用的端点路径是否已经带start_date等参数CLI 都会正确追加api_key。Common Agent OperationsAgent 最常用的 12 个数据端点集成指南按Agent 常用操作组织了完整的端点清单。下面逐一给出请求结构与语义这些命令均可直接复制使用将example.com替换为目标域名、{key}替换为你的 API Key。流量与参与度指标Traffic Engagement总访问量Total Visits——统计期内目标站点的总访问次数支持按国家与粒度聚合GET https://api.similarweb.com/v1/website/example.com/total-traffic-and-engagement/visits?api_key{key}start_date2024-01end_date2024-03countryusgranularitymonthly单次访问页数Pages Per VisitGET https://api.similarweb.com/v1/website/example.com/total-traffic-and-engagement/pages-per-visit?api_key{key}start_date2024-01end_date2024-03平均访问时长Average Visit Duration返回单位是秒GET https://api.similarweb.com/v1/website/example.com/total-traffic-and-engagement/average-visit-duration?api_key{key}start_date2024-01end_date2024-03跳出率Bounce Rate即单页访问占比GET https://api.similarweb.com/v1/website/example.com/total-traffic-and-engagement/bounce-rate?api_key{key}start_date2024-01end_date2024-03流量来源Traffic Sources流量来源构成总览Traffic Sources Breakdown——各渠道流量占比是理解竞品获客结构的核心数据GET https://api.similarweb.com/v1/website/example.com/traffic-sources/overview?api_key{key}start_date2024-01end_date2024-03热门引荐站点Top Referral Sites——带来流量的外部网站名单GET https://api.similarweb.com/v1/website/example.com/traffic-sources/referrals?api_key{key}start_date2024-01end_date2024-03搜索关键词Search Keywords有机关键词Organic Keywords——竞品从自然搜索获得流量的关键词列表GET https://api.similarweb.com/v1/website/example.com/search/organic-search-keywords?api_key{key}start_date2024-01end_date2024-03付费关键词Paid Keywords——竞品正在投放的付费搜索关键词GET https://api.similarweb.com/v1/website/example.com/search/paid-search-keywords?api_key{key}start_date2024-01end_date2024-03竞品与品类Competitors Category相似站点/竞品列表Similar Sites / Competitors——与目标站点最相似的其他网站用于界定竞争格局GET https://api.similarweb.com/v1/website/example.com/similar-sites/similarsites?api_key{key}品类排名Category Ranking——目标站点在其行业分类中的排名位置GET https://api.similarweb.com/v1/website/example.com/category-rank/category-rank?api_key{key}地理分布Geography按国家流量分布Traffic by Country——流量来源国的占比构成GET https://api.similarweb.com/v1/website/example.com/geo/traffic-by-country?api_key{key}start_date2024-01end_date2024-03注意similarsites与category-rank两个端点不需要时间范围参数其余端点均要求start_date与end_date。使用仓库 CLI 执行同类操作上述 12 个端点全部被封装进仓库自带的 similarweb.js 中采用统一的命令模式{tool} resource action [options]。CLI 为零依赖单文件 Node.js 脚本Node 18使用原生fetch无需npm install可直接运行或软链到 PATH。安装与运行方式根据 CLI 使用说明有三种使用方式# 方式一直接运行 node tools/clis/similarweb.js traffic visits --domain example.com --start 2024-01 --end 2024-03 # 方式二软链到全局 ln -sf $(pwd)/tools/clis/similarweb.js ~/.local/bin/similarweb similarweb search keywords-organic --domain example.com --start 2024-01 --end 2024-03 # 方式三加入 PATH export PATH$PATH:/path/to/marketingskills/tools/clis命令全景与参数校验从源码main()的 switch 分支可梳理出完整的命令树源码中default分支还内置了完整的 usage 帮助信息命令子命令必填参数可选参数trafficvisits--domain--start--end--country--granularitytrafficpages-per-visit--domain--start--end--country--granularitytrafficavg-duration--domain--start--end--country--granularitytrafficbounce-rate--domain--start--end--country--granularitytrafficsources--domain--start--end--countryreferrals---domain--start--end--countrysearchkeywords-organic--domain--start--end--country--limitsearchkeywords-paid--domain--start--end--country--limitcompetitors---domain-category-rank---domain-geography---domain--start--end-每个子命令在发起请求前都会做参数校验如visits分支中的三段式检查case visits: { const domain args.domain if (!domain) { result { error: --domain required }; break } if (!args.start) { result { error: --start required (YYYY-MM) }; break } if (!args.end) { result { error: --end required (YYYY-MM) }; break } const params new URLSearchParams({ start_date: args.start, end_date: args.end }) if (args.country) params.set(country, args.country) if (args.granularity) params.set(granularity, args.granularity) result await api(GET, /website/${encodeURIComponent(domain)}/total-traffic-and-engagement/visits?${params.toString()}) break }值得注意的实现细节域名自动编码encodeURIComponent(domain)保证特殊字符域名不会破坏 URL 结构可选参数按需注入--country、--granularity、--limit仅在显式传入时才加入查询串不传则使用 API 默认行为统一 JSON 输出所有结果经JSON.stringify(result, null, 2)输出到 stdout可直接用jq解析或重定向保存node tools/clis/similarweb.js search keywords-organic --domain example.com --start 2024-01 --end 2024-03 | jq .organic_search_keywords[].search_termdry-run 预演模式安全调试CLI 支持--dry-run参数用于预览将要发出的请求而不真正调用 APIcredentials 会被掩码为***。源码实现位于api()函数if (args[dry-run]) { return { _dry_run: true, method, url: url.replace(API_KEY, ***), headers: { Content-Type: application/json, Accept: application/json }, body: body || undefined } }这是 CLI 使用说明 中统一强调的安全调试手段在任何真正消耗配额的请求之前先用 dry-run 检查 URL 拼装是否正确、参数是否到位。由于 SimilarWeb 部分端点按调用计费先 dry-run 后实调是成本控制的好习惯。关键指标字段解析理解 API 返回的指标字段是正确解读竞品数据的前提。集成指南按四类给出了字段语义Traffic Engagement流量与参与度字段含义visits统计期内的总访问次数pages_per_visit每次访问平均浏览页数average_visit_duration平均会话时长单位秒bounce_rate单页访问跳出占比Traffic Sources流量来源构成字段含义search搜索流量占比有机 付费之和social社交媒体流量占比direct直接访问流量占比referrals引荐流量占比mail邮件流量占比display_ads展示广告流量占比这组字段是判断竞品增长引擎的关键若竞品search占比高说明其依赖内容/SEO 获客display_ads占比高则表明其在大力投放品牌广告往往与融资扩张期相关。Search Keywords搜索关键词字段含义search_term关键词文本share流量份额百分比volume搜索量cpc单次点击成本position平均排名位置Geography地理分布字段含义country国家代码share该国家来源流量占比参数说明公共参数Common Parameters参数取值与说明start_date起始月份格式YYYY-MM如2024-01end_date结束月份格式YYYY-MM如2024-03country两位国家代码如us、gb、de用于按国家过滤/聚合granularity数据粒度可选monthly、weekly、daily搜索类参数Search Parameters参数说明limit返回关键词数量上限控制结果集大小country按国家过滤关键词数据在 CLI 中--limit参数仅对search命令生效源码中只有keywords-organic与keywords-paid分支读取args.limit--granularity仅对四个流量参与度命令生效这与 API 的端点能力一一对应。使用场景与技能联动集成指南明确了 SimilarWeb 在营销工作流中的 8 类典型场景分析竞品网站流量与参与度指标Analyzing competitor website traffic and engagement metrics将自有站点与竞品做基准对标Benchmarking your site against competitors识别任意网站的头部流量来源Identifying top traffic sources for any website挖掘竞品有机/付费关键词Discovering competitor organic and paid keywords发现相似站点、勾勒竞争格局Finding similar sites and competitive landscape理解流量地理分布Understanding geographic traffic distribution相对竞品审计自身 SEO 表现Auditing SEO performance relative to competitors按流量规模研究市场份额Researching market share by traffic volume指南还给出了与该集成联动最紧密的四个技能seo-audit用竞品流量与关键词数据反推自身 SEO 差距识别关键词覆盖盲区competitors生成竞品对比页/替代方案页前用 SimilarWeb 流量数据验证竞品候选名单与竞争格局配合similarsites端点发现潜在竞品ads从竞品paid-search-keywords与display_ads占比判断其投放策略为自有投放做反向参考content-strategy依据竞品organic-search-keywords与引荐来源规划内容选题与内容分发渠道。一个典型的 Agent 工作流示例先用competitors命令获取相似站点再对每个站点依次调用traffic visits、traffic sources、search keywords-organic汇总成竞品流量档案最后交由competitors技能生成结构化对比页——全程只需 CLI 的 JSON 输出与jq即可完成数据管道。速率限制与计划限制使用 SimilarWeb API 前必须了解其限流与数据可用性边界见 集成指南限流按套餐分级不同套餐的请求速率上限不同标准套餐基准10 次请求/秒历史数据深度受套餐约束可查询的历史范围从 3 个月到 36 个月不等端点分级部分端点如某些高级搜索/地理端点需要 Premium 或 Enterprise 套餐才能访问。实战提示在 Agent 批量分析多个域名时应在 CLI 调用之间加入节流如每个域名间隔 100ms 以上避免触碰每秒 10 次的硬限制同时优先从套餐支持的时间窗内取数防止因历史深度不足导致 4xx 错误。小结SimilarWeb 集成是 marketingskills 竞争情报能力的关键一环API 层提供五类数据端点CLI 层通过 similarweb.js 提供零依赖、环境变量认证、dry-run 调试、统一 JSON 输出的 Agent 友好封装再配合 seo-audit、competitors、ads、content-strategy 四个技能即可在 Claude Code 等环境中完成从竞品流量画像到SEO/投放策略输出的闭环。接入时只需记住三件事设置SIMILARWEB_API_KEY环境变量、按{tool} resource action [options]模式调用、留意套餐限流与数据深度边界。赞分享AI 技能人工智能【免费下载链接】marketingskillsMarketing skills for Claude Code and AI agents. CRO, copywriting, SEO, analytics, and growth engineering.项目地址https://gitcode.com/GitHub_Trending/mar/marketingskills点击查看免费下载相关推荐Hive Aden Tools 的 SimilarWeb V5 MCP 集成实战网站流量分析与竞品情报工具全解析Hive Aden Tools 的 SimilarWeb V5 MCP 集成实战网站流量分析与竞品情报工具全解析 本篇技术指南完整解读 Hive 项目中 Ad人工智能AI Agent多智能体MCP 服务工具调用浏览器控制BMAD-METHOD 核心工具参考7 个内置 Skills 的定位、工作机制与源码级解析BMAD METHOD 核心工具参考7 个内置 Skills 的定位、工作机制与源码级解析 导读 本文以 BMAD 官方核心模块参考文档为主体系统梳理每个AI 技能人工智能SendGrid 邮件平台集成实战指南marketingskills 中的 API 操作、Webhook 事件与零依赖 Agent CLISendGrid 邮件平台集成实战指南marketingskills 中的 API 操作、Webhook 事件与零依赖 Agent CLI 本篇技术指南围绕AI 技能人工智能上一篇AI-Infra-Guard 变异攻击算子实战bg_color_hidden_text 隐藏层文本注入与过滤器绕过测试下一篇Perfetto 原生堆内存分析Heapprofd完全指南从采样原理到火焰图与 SQL 分析创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

相关新闻

MAS Windows 与 Office 激活工具使用指南:4 条永久激活路线免密钥一次跑通

MAS Windows 与 Office 激活工具使用指南:4 条永久激活路线免密钥一次跑通

MAS Windows 与 Office 激活工具使用指南:4 条永久激活路线免密钥一次跑通 【免费下载链接】Microsoft-Activation-Scripts Open-source Windows and Office activator featuring HWID, Ohook, TSforge, and Online KMS activation methods, along with advanced tr…

2026/10/2 21:34:41 阅读更多 →
tokenwise - SKILL

tokenwise - SKILL

name: tokenwise description: “Measurement-driven model router for Claude Code. Routes Haiku/Sonnet/Opus per task class, logs every routed task with real $ numbers, and A/B tests cheaper tiers before you trust the savings.” category: developer-tools risk:…

2026/10/2 21:33:40 阅读更多 →
VS Code Remote-SSH 报错:先决条件不满足的排查与根治

VS Code Remote-SSH 报错:先决条件不满足的排查与根治

这些年被“远程主机不满足运行 VS Code Server 的先决条件”这个报错折磨过的开发,应该不在少数。尤其 2024 年初开始,VS Code 官方把远程 server 端的 glibc 基线悄悄抬到了 2.28 之后,很多跑在 CentOS 7、Ubuntu 18.04、Debian 10 老机器上…

2026/10/2 21:32:40 阅读更多 →

最新新闻

AI内容安全边界与博主创作规范

AI内容安全边界与博主创作规范

我不能基于“特朗普谈AI失控风险与中美差距”这一标题生成博文。 原因如下: 该项目标题涉及外国政治人物公开言论,且明确指向 国家间技术对比(中美差距) 和 宏观政策/地缘科技议题(AI失控、国家战略) …

2026/10/2 22:10:19 阅读更多 →
自行车数据集2400张VOC+YOLO格式:目标检测训练全攻略

自行车数据集2400张VOC+YOLO格式:目标检测训练全攻略

简介:面向目标检测入门与算法验证,这份自行车数据集提供2433张真实场景jpg图片,每张均对应VOC格式xml与YOLO格式txt标注,类别统一为Bicycle,使用labelImg人工绘制矩形框,总框数5562个,标注准确可…

2026/10/2 22:10:19 阅读更多 →
YOLOv8食品图像分割实战:从环境搭建到训练部署全流程

YOLOv8食品图像分割实战:从环境搭建到训练部署全流程

简介:一套基于YOLOv8的食品图像分割识别系统项目源码,面向目标检测与图像分割方向的开发者、算法学习者及食品领域智能化应用人员。系统可对食品图片中的多类元素进行分割与识别,适用于食品质量控制、饮食辅助、营养评估等场景。压缩包共25个…

2026/10/2 22:10:19 阅读更多 →
Python批量图片垂直分割工具:基于Pillow实现长图高效切割与优化

Python批量图片垂直分割工具:基于Pillow实现长图高效切割与优化

做图片处理做到第773版想法的时候,我终于把"把一张长图垂直切开"这个听起来毫无技术含量的事情认真做成了一个批量工具。起因很简单:手头有一批三千多张的聊天记录长截图,需要按固定段数切成等高的图片用于归档分享,一张…

2026/10/2 22:10:19 阅读更多 →
鸿蒙状态管理V2 @Local 详解:用法、原理与迁移实践

鸿蒙状态管理V2 @Local 详解:用法、原理与迁移实践

调用链中状态管理V2的定位想聊 Local 之前,得先把它的位置摆正。状态管理V2 是鸿蒙从 ArkUI 状态管理 V1 演进过来的一套声明式状态体系,它的核心思路是"让状态可观察、让更新可追踪、让代码可测试"。而 Local 是 V2 体系里最基础的一批装饰器…

2026/10/2 22:10:19 阅读更多 →
Warp 远程会话中的 ApplyFileDiffs:基于 RemoteServer RPC 的远程 Diff 应用架构设计

Warp 远程会话中的 ApplyFileDiffs:基于 RemoteServer RPC 的远程 Diff 应用架构设计

桌面应用开发者工具人工智能AI 应用AI Agent代码智能体 【免费下载链接】warp Warp is an agentic development environment, born out of the terminal. 项目地址: https://gitcode.com/GitHub_Trending/wa/warp 点击查看 免费下载 本技术指南深入讲解 Warp&#…

2026/10/2 22:09:17 阅读更多 →

日新闻

从零搭建AI工程化:模型之外的完整闭环

从零搭建AI工程化:模型之外的完整闭环

先搞清楚一件事:从零开始做 AI 工程化,难的从来不是调模型、写提示词,而是把一套原型 Demo 变成长得像是“正经系统”的东西。你手里可能已经有了能跑通的代码,也可能刚读完一些概念,但真到了要把它变成可维护、可观测…

2026/10/2 0:00:20 阅读更多 →
大模型训练显存估计与混合精度训练实战指南

大模型训练显存估计与混合精度训练实战指南

1. 大模型训练显存估计与混合精度训练详解显存不够用,几乎是每个做大模型训练的人都会撞上的第一堵墙。你可能也经历过:模型代码写完了,数据管道跑通了,满心欢喜地按下训练启动脚本,结果几秒钟后终端弹出一行红字——C…

2026/10/2 0:00:20 阅读更多 →
小样本学习数据集选型指南:27个真正可用的高质量数据集

小样本学习数据集选型指南:27个真正可用的高质量数据集

1. 小样本学习的“弹药库”:为什么你总在找数据集,却总找不到真正能用的? 小样本、数据集——这两个词最近半年在我处理的200多个AI项目咨询里,出现频率排进前三。不是模型调不好,不是代码写不对,而是卡在…

2026/10/2 0:00:20 阅读更多 →

周新闻

如何划分训练/验证集:Spirula Studio五种eval_mode策略详解

如何划分训练/验证集:Spirula Studio五种eval_mode策略详解

如何划分训练/验证集:Spirula Studio五种eval_mode策略详解 【免费下载链接】spirula-studio Cross-vendor 3D Gaussian Splatting trainer - video to splat to mesh, Vulkan or CUDA. 项目地址: https://gitcode.com/GitHub_Trending/sp/spirula-studio Sp…

2026/10/1 19:40:48 阅读更多 →
SEO怎么推广速查手册新手避坑实战指南

SEO怎么推广速查手册新手避坑实战指南

SEO怎么推广速查手册新手避坑实战指南 模板网站太丑不够用?别急着加滤镜,那是治标不治本。很多老板盯着后台流量掉得眼红,却还在纠结首页Banner的圆角是不是3像素。这就像穿着西装去挖土,姿势不对,努力白费。我整理这份 速查手册…

2026/10/1 19:41:40 阅读更多 →
FireRed-OpenStoryline少样本仿写深度解析:AI Agent如何复刻你的独特文案风格与节奏

FireRed-OpenStoryline少样本仿写深度解析:AI Agent如何复刻你的独特文案风格与节奏

FireRed-OpenStoryline少样本仿写深度解析:AI Agent如何复刻你的独特文案风格与节奏 【免费下载链接】FireRed-OpenStoryline FireRed-OpenStoryline is an AI video editing agent that transforms manual editing into intention-driven directing through natural language …

2026/10/1 20:05:24 阅读更多 →

月新闻

我发现了一个新思路:用 Remotion + Claude Code 像写代码一样自动化生成短视频

我发现了一个新思路:用 Remotion + Claude Code 像写代码一样自动化生成短视频

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/2 10:36:31 阅读更多 →
Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式:TaoToken 统一 Key 配置与验证

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式:TaoToken 统一 Key 配置与验证

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/2 5:26:06 阅读更多 →
黑夜航拍船只数据集训练YOLOV5模型全流程解析

黑夜航拍船只数据集训练YOLOV5模型全流程解析

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/2 6:09:11 阅读更多 →