用途:为智能体提供 Similarweb 网站情报,回答关于某网站流量、受众、流量来源、技术栈或搜索足迹的问题。关键词量与难度应改用 DataForSEO 或 Semrush 技能,外链用 Ahrefs。
主要能力:通过 AIsa API 查询 Similarweb 数据。技能本身不保存端点参数和价格,因为二者随时间变化,需在运行时从在线契约读取:参数来自 https://aisa.one/docs/openapi/similarweb.json,费用来自调用前的免费报价与响应中的成本头。
使用方式: 配置环境变量:export AISA_API_KEY="sk-aisa-..." 基础地址 https://api.aisa.one/apis/v1/similarweb,请求头 Authorization: Bearer $AISA_API_KEY。密钥账号需订阅 Go-to-Market Plan,详见 https://aisa.one/solutions/go-to-market。切勿打印或提交密钥;缺失时请用户设置 AISA_API_KEY。 常用命令: python3 scripts/similarweb_client.py discover 获取路由索引 python3 scripts/similarweb_client.py describe ROUTE 查看某路由参数、枚举、限制与日期规则 python3 scripts/similarweb_client.py window 获取最新完整数据月份 python3 scripts/similarweb_client.py check ROUTE name=value … 依契约校验,不调用 API python3 scripts/similarweb_client.py quote ROUTE name=value … 免费估价 python3 scripts/similarweb_client.py call ROUTE name=value … --max-usd "$APPROVED_USD" 调用 python3 scripts/similarweb_client.py usage --days 1 查询已计费金额 其中 ROUTE 为 discover 返回的路径(去掉 /similarweb 前缀),name=value 均来自 describe。
两条规则:成本规则,不得陈述或假设价格,价格只能来自调用前报价或响应头 x-aisa-customer-cost-micros-usd;契约规则,不得假设参数,每个请求都依据在线契约构建。
调用流程:先 discover 获取并缓存契约,describe 读取所需路由,window 找最新数据月份;构建最小请求、免费报价、必要时对更宽范围再报价比较,向用户展示报价并获取授权,再用 --max-usd 上限调用(会设置 X-AISA-Max-Price-USD 与 Idempotency-Key,不带 --max-usd 仅报价);最后报告 cost_usd 与 data_month,并用 usage 对账。
响应处理:400 带 meta.error_message 表示日期窗口规则被违反,未计费,可据提示修正重试;400 带 error.supported 给出参数合法值;402 表示估价超上限;409 表示 Idempotency-Key 已使用;503 带 retryable: true 可用新密钥重试一次,均未计费。不要重试 200。付费调用请用 REST 以获取成本头。
输出:call 打印 JSON,含 status、quoted_usd、cost_usd、request_id、latency_s、data_month、note 与 data。报告数字时须同时报告数据月份。
其它:契约见 https://aisa.one/docs/openapi/similarweb.json;MCP 见 https://mcp.aisa.one/similarweb/mcp;用量查询 GET https://api.aisa.one/v1/usage?start_time=<unix>。许可证 MIT。二十行协议见 references/agent-rules.txt,发现细节见 references/discovery.md,成本控制见 references/cost-control.md。