sigpikAI SaaS 市场动态与竞争情报工作台。
切换语言中文
EN中文
Sigpik 数据情报

开发者平台v1

REST
https://sigpik.com/api/v1
MCP
https://sigpik.com/api/mcp
下载 OpenAPI获取开发者权限

快速上手

身份验证

公开 API 无需密钥即可使用。免费版与 Starter 可创建仅含 MCP 工具权限的 API Key，使用基础工具，每月分别 100 次和 1,000 次。Pro 提供完整 API 与 MCP，每月 3,000 次。获得开发者体验权限后，可以在有限额度内测试 MCP 和研究 API；Enterprise 额度按合同约定。

AuthorizationBearer spk_live_…
  • 已登录账户都可以创建 API Key。免费账户仅限 mcp:tools 权限；获得邀请体验、Pro 或 Enterprise 权限的账户可以授予研究权限。
  • 使用 Authorization: Bearer spk_live_… 请求头发送 API Key。
  • 只启用当前集成需要的权限。发起调查须显式授予 research:execute；管理信号订阅须授予 webhooks:manage。
  • 完整 Key 只显示一次，之后可以随时撤销。
  • 同一账户下的多个 Key 共享开发者体验额度。
  • 暂不支持 OAuth，Remote MCP 当前使用 API Key 认证。
公开 API

获取公开产品信息 · Remote MCP 需要 API Key；免费版与 Starter 可创建仅含 MCP 工具权限的 Key，用于产品概览、赛道与信号（每月分别 100 次和 1,000 次）

开发者体验权限

每个 UTC 月可在受保护 REST 与 MCP 之间共享 50 次计入额度的调用 · 公开目录、API Key 管理、初始化、工具发现、ping、通知和失败的调用不计入额度 · 每次最多返回 10 条结果 · 仅返回最新观测月份，最多提供 5 个产品赛道筛选项

Pro / Enterprise

完整的 Rankings 数据 · 通过 Remote MCP 使用产品概览、推广调查与榜单 · Pro 每个 UTC 月 3,000 次计数调用，REST 与 MCP 共享；Enterprise 按合同约定 · 每分钟最多 120 次请求 · 仍需遵守请求频率限制

开发者体验权限仅限邀请，需登录账户后获得授权。 SaaS Ideas 尚在开发测试，仅向活跃管理员开放网页预览，暂不提供公开 API 或 MCP 工具。

请求示例
POST/research/promotion-investigations
curl "https://sigpik.com/api/v1/research/promotion-investigations" -X POST \
  -H "Authorization: Bearer $SIGPIK_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{"slug":"example-ai","locale":"en","idempotency_key":"b46b2db0-8a30-4d69-a33e-8b5b4509c279","confirm_usage":true}'

本地模拟 · 数据仅作示例，不发送请求、不消耗额度。

202 Accepted响应示例 · 节选JSON
{
  "task_id": "task_b46b2db0-8a30-4d69-a33e-8b5b4509c279",
  "type": "promotion_investigation",
  "status": "queued",
  "stage": "queued",
  "created_at": "2026-09-17T05:00:00.000Z",
  "updated_at": "2026-09-17T05:00:00.000Z",
  "completed_at": null,
  "status_url": "/api/v1/research/promotion-investigations/task_b46b2db0-8a30-4d69-a33e-8b5b4509c279",
  "result_url": null,
  "poll_after_seconds": 60,
  "error": null,
  "report": null
}

快速上手

频控与错误

开发者 Key 每 60 秒最多 120 次请求。月额度（免费版 100、Starter 1,000、Pro 3,000、邀请体验按授权）由账户内所有密钥共享。

X-Quota-* 响应头描述账户的月额度；公开目录、Enterprise 与免配额账户不返回相同的额度头。REST 的 429 可能表示短期频控或月额度耗尽（附 Retry-After），失败的请求不计次数。MCP 额度耗尽时以 PRO_API_QUOTA_EXHAUSTED 工具错误返回。

400

参数或游标无效，修正后重试。

401

缺失、无效或已撤销的 API Key。

403

Key 权限或账户访问级别不足。

404

未找到产品或资源。

409

幂等键与请求参数冲突。

429

触发频控或月额度耗尽，请检查错误码与重置响应头。

503

数据暂时不可用，请退避后重试。

429 · X-Quota-Reset
HTTP
HTTP/1.1 429 Too Many Requests
X-Quota-Limit: 50
X-Quota-Remaining: 0
X-Quota-Policy: 50;month
X-Quota-Reset: 2026-10-01T00:00:00.000Z

{
  "error": {
    "code": "PRO_API_QUOTA_EXHAUSTED",
    "message": "Developer Access call quota is exhausted.",
    "details": { "limit": 50, "remaining": 0 }
  },
  "request_id": "example-request-id"
}

Public API · Free

公共免费 API

无需注册、订阅或 Sigpik API Key。通过标准 HTTP 请求获取榜单与异动精选，返回 JSON 数据，可自由组合到你的应用、脚本和自动化流程中。

精选榜单

GET/api/public/v1/rankings

最多 5 款产品，按可比月份的访问量绝对增量排序。前后月份均至少有 1,000 估算访问量。

每条记录包含 rank、estimated_visits、previous_estimated_visits、visits_change、growth_rate，以及 period.current_month 和 period.previous_month。增长率 0.314 表示 31.4%。

精选异动

GET/api/public/v1/signals

最多 5 条高重要性、已确认且已发布的异动摘要，每个产品最多一条。从发布日 UTC 零点前七天的近期观察中选取。

每条记录包含 type、title、summary、direction、before、after、observed_at、published_at 和 period。before / after 为可公开的标量变化值与单位，无可用值时为 null。

参数与响应

仅支持 locale=en（默认）或 locale=zh-CN。每天发布一份所有用户相同的精选，切换语言不改变记录集合。不支持翻页、筛选、任意产品查询或历史版本读取。

字段说明
edition

当前精选的发布日期（UTC）。

published_at

精选生成时间，不等于数据观测时间。

stale

为 true 时表示当天精选尚未更新，请结合发布时间判断是否使用。

items

最多 5 条精选记录，允许少于 5 条或为空。

items[].id

稳定记录标识，可用于去重。

items[].product

产品名称、slug 和详情链接。

source_url

对应的榜单或信号页面。

榜单基于月度估算数据；精选异动不是实时或完整事件流。精选更新延迟时最多保留 48 小时，超过后返回 503。

调用与频控

无需 Authorization 请求头，不扣账户 API 月度次数。每 IP 每分钟最多 120 次请求（边缘频控），建议每天读取一次。支持 ETag / If-None-Match，数据未变化时返回 304。

400 表示参数不受支持；429 表示触发频控；503 表示精选暂不可用。遇到 429 或 503 时遵循 Retry-After 等待后重试。

公共免费 API · OpenAPI调用示例与字段说明

核心商业情报

发起推广调查

POST/api/v1/research/promotion-investigations

复用详情页的推广历史调查，研究一个产品并生成报告。显式使用账户现有调查额度；重试相同请求时复用同一个 UUID。返回任务 ID，不提供全量数据导出。

所需权限 research:execute

请求参数

字段 / 类型说明与约束
slug
string可选body

产品或分类的规范 slug。

minLength: 1 · maxLength: 200
domain
string可选body

产品域名或 URL；查找前会规范化。

minLength: 1 · maxLength: 253
locale
enum可选body

返回语言：en 或 zh-CN。

default: "en" · en | zh-CN
idempotency_key
string必选body

UUID；重试相同产品和语言时复用，不同调查使用新值。

pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
confirm_usage
enum必选body

必须为 true，明确确认使用现有调查额度。

true
返回字段12
字段 / 类型说明与约束
task_id
string必选response

提交后返回的随机任务 ID。

pattern: ^task_[0-9a-f-]{36}$
type
enum必选response

任务类型：推广调查。

promotion_investigation
status
enum必选response

详见返回示例与完整 Schema。

queued | running | succeeded | failed | cancelled
stage
enum必选response

详见返回示例与完整 Schema。

queued | investigating | generating_report | complete
status_url
string必选response

详见返回示例与完整 Schema。

result_url
string | null必选response

详见返回示例与完整 Schema。

poll_after_seconds
integer | null必选response

详见返回示例与完整 Schema。

created_at
string必选response

详见返回示例与完整 Schema。

updated_at
string必选response

详见返回示例与完整 Schema。

completed_at
string | null必选response

详见返回示例与完整 Schema。

error
object | null必选response

详见返回示例与完整 Schema。

report
object必选response

详见返回示例与完整 Schema。

请求示例
POST/research/promotion-investigations
curl "https://sigpik.com/api/v1/research/promotion-investigations" -X POST \
  -H "Authorization: Bearer $SIGPIK_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{"slug":"example-ai","locale":"en","idempotency_key":"b46b2db0-8a30-4d69-a33e-8b5b4509c279","confirm_usage":true}'

本地模拟 · 数据仅作示例，不发送请求、不消耗额度。

202 Accepted响应示例 · 节选JSON
{
  "task_id": "task_b46b2db0-8a30-4d69-a33e-8b5b4509c279",
  "type": "promotion_investigation",
  "status": "queued",
  "stage": "queued",
  "created_at": "2026-09-17T05:00:00.000Z",
  "updated_at": "2026-09-17T05:00:00.000Z",
  "completed_at": null,
  "status_url": "/api/v1/research/promotion-investigations/task_b46b2db0-8a30-4d69-a33e-8b5b4509c279",
  "result_url": null,
  "poll_after_seconds": 60,
  "error": null,
  "report": null
}

核心商业情报

调查进度与报告 · 免费

GET/api/v1/research/promotion-investigations/{task_id}

一次读取调查进度与最终报告。queued/running 时 report 为 null，succeeded 时包含完整报告；failed/cancelled 为终态。查询不扣调查额度和 API 月度次数，月度次数用完仍可查。等待期间按 60 秒间隔轮询，未知或其他账户 ID 返回 404。

所需权限 research:read

请求参数

字段 / 类型说明与约束
task_id
string必选path

提交后返回的随机任务 ID。

返回字段12
字段 / 类型说明与约束
task_id
string必选response

提交后返回的随机任务 ID。

pattern: ^task_[0-9a-f-]{36}$
type
enum必选response

任务类型：推广调查。

promotion_investigation
status
enum必选response

详见返回示例与完整 Schema。

queued | running | succeeded | failed | cancelled
stage
enum必选response

详见返回示例与完整 Schema。

queued | investigating | generating_report | complete
status_url
string必选response

详见返回示例与完整 Schema。

result_url
string | null必选response

详见返回示例与完整 Schema。

poll_after_seconds
integer | null必选response

详见返回示例与完整 Schema。

created_at
string必选response

详见返回示例与完整 Schema。

updated_at
string必选response

详见返回示例与完整 Schema。

completed_at
string | null必选response

详见返回示例与完整 Schema。

error
object | null必选response

详见返回示例与完整 Schema。

report
object必选response

详见返回示例与完整 Schema。

请求示例
GET/research/promotion-investigations/{task_id}
curl "https://sigpik.com/api/v1/research/promotion-investigations/task_b46b2db0-8a30-4d69-a33e-8b5b4509c279" \
  -H "Authorization: Bearer $SIGPIK_API_KEY"

本地模拟 · 数据仅作示例，不发送请求、不消耗额度。

200 OK响应示例 · 节选JSON
{
  "task_id": "task_b46b2db0-8a30-4d69-a33e-8b5b4509c279",
  "type": "promotion_investigation",
  "status": "succeeded",
  "stage": "complete",
  "created_at": "2026-09-17T05:00:00.000Z",
  "updated_at": "2026-09-17T05:00:00.000Z",
  "completed_at": "2026-09-17T05:10:00.000Z",
  "status_url": "/api/v1/research/promotion-investigations/task_b46b2db0-8a30-4d69-a33e-8b5b4509c279",
  "result_url": "/api/v1/research/promotion-investigations/task_b46b2db0-8a30-4d69-a33e-8b5b4509c279",
  "poll_after_seconds": null,
  "error": null,
  "report": {
    "version": "example",
    "generated_at": "2026-09-17T05:10:00.000Z",
    "narrative": {
      "title": "Example promotion history",
      "summary": {
        "text": "Illustrative report: published sources describe a launch and later community activity.",
        "citations": []
      },
      "sections": [],
      "limitations": "Illustrative response. Actual reports include only available evidence."
    },
    "summary": {
      "actionEvidenceCount": 0,
      "channelCount": 0,
      "contextLeadCount": 0,
      "sourceCount": 0,
      "unresolvedActionCount": 0
    },
    "analysis": {
      "overview": "Illustrative report.",
      "method": "",
      "observations": [],
      "phases": [],
      "channels": [],
      "openQuestions": []
    },
    "timeline": [],
    "strategies": [],
    "sources": [],
    "context_leads": [],
    "conclusion": "Observed promotion does not establish growth causality.",
    "limitations": [
      "Examples are not live research results."
    ],
    "caveat": "Coverage depends on available public evidence.",
    "reliability": {
      "actorAttribution": "unknown",
      "coverageLevel": "limited",
      "growthCausality": "not_established",
      "growthImpact": "unknown"
    },
    "omitted_action_count": 0,
    "omitted_context_count": 0
  }
}

核心商业情报

AI 产品排名

GET/api/v1/research/rankings

比较增长、访问量、域名评分、搜索与 AI 引荐表现。

所需权限 research:read

邀请体验固定第 1 页、最多 10 条；付费访问取决于账户功能。增长值为比率，null 表示暂无数据。

请求参数

字段 / 类型说明与约束
locale
string可选query

返回语言：en 或 zh-CN。

default: "en" · maxLength: 20
category
string可选query

按分类 slug 筛选。

maxLength: 120
country
string可选query

两位字母国家代码。

pattern: ^[A-Za-z]{2}$
q
string可选query

搜索关键词。

maxLength: 80
preset
enum可选query

详见返回示例与完整 Schema。

opportunities | trending | fastest-growing | most-visited | ai-referrals | breakouts | new-rising
sort
enum可选query

结果排序指标。

default: "growth" · growth | gain | traffic | dr_growth | organic | ai | paid | duration
order
enum可选query

排序方向。

default: "desc" · asc | desc
min_traffic
integer可选query

最低观测流量。

default: 1000 · min: 0 · max: 9007199254740991
min_growth
number可选query

最低增长比率；0.1 表示 10%。

default: 0 · min: 0 · max: 100
min_dr
number可选query

最低域名评分。

default: 0 · min: 0 · max: 100
min_dr_gain
number可选query

最低域名评分增量。

default: 0 · min: 0 · max: 100
max_domain_age_months
integer可选query

最大域名月龄；0 关闭筛选。

default: 0 · min: 0 · max: 120
page
integer可选query

页码；邀请体验固定返回第 1 页。

default: 1 · min: 1 · max: 200
limit
integer可选query

每页最多返回的记录数。

default: 25 · min: 1 · max: 50
返回字段8
字段 / 类型说明与约束
category
object | null可选response

按分类 slug 筛选。

dataset
object必选response

数据观测时间与覆盖范围。

eligible_population
integer必选response

符合榜单条件的产品总数。

filters
object必选response

实际生效的筛选条件。

items
array必选response

结果记录，字段随端点和账户权限变化。

pagination
object必选response

页码、每页数量与翻页状态。

requested_locale
string必选response

请求的返回语言。

resolved_locale
string必选response

实际可用的返回语言。

请求示例
GET/research/rankings
curl "https://sigpik.com/api/v1/research/rankings?sort=growth&limit=10" \
  -H "Authorization: Bearer $SIGPIK_API_KEY"

本地模拟 · 数据仅作示例，不发送请求、不消耗额度。

200 OK响应示例 · 节选JSON
{
  "dataset": {
    "methodology_version": "example"
  },
  "eligible_population": 1,
  "filters": {
    "sort": "growth",
    "limit": 10
  },
  "items": [
    {
      "rank": 1,
      "tool_id": 1042,
      "name": "Example AI",
      "slug": "example-ai",
      "normalized_domain": "example.ai",
      "primary_category_name": "Productivity",
      "primary_category_slug": "productivity",
      "latest_month": "2026-08",
      "previous_month": "2026-07",
      "latest_visits": 131400,
      "previous_visits": 100000,
      "visits_change": 31400,
      "growth_rate": 0.314,
      "domain_rating": null,
      "favicon_url": null
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "has_more": false
  },
  "requested_locale": "en",
  "resolved_locale": "en"
}

异动通知

订阅产品信号

POST/api/v1/alerts/webhooks

推送你已关注产品的新发布、已确认信号。接收端须对验证 POST 返回 HTTP 2xx 和 {"challenge":"收到的值"}。保存仅显示一次的 signing_secret；通知独立于邮件和推广调查。

在 Dashboard 中管理接收端点、签名密钥和投递记录。

信号事件与验签

signal.published · JSON
{
  "id": "sig_1234_1042",
  "version": "1",
  "type": "signal.published",
  "created_at": "2026-09-17T05:00:00.000Z",
  "data": {
    "signal_id": 1234,
    "signal_type": "traffic_breakout",
    "product": {
      "id": 1042,
      "slug": "example-ai"
    },
    "title": "Traffic breakout",
    "summary": "Illustrative signal: monthly traffic increased.",
    "change": {
      "direction": "up",
      "magnitude": 0.7,
      "before": {
        "value": 10000,
        "unit": "visits"
      },
      "after": {
        "value": 17000,
        "unit": "visits"
      }
    },
    "observed_at": "2026-09-17T05:00:00.000Z",
    "period": {
      "start": "2026-08-01",
      "end": "2026-08-31"
    },
    "published_at": "2026-09-17T05:00:00.000Z",
    "evidence_summary": "Illustrative monthly observation; does not establish growth causality.",
    "url": "https://sigpik.com/tools/example-ai"
  }
}

X-Sigpik-Signature: t=<Unix 秒>,v1=<HMAC-SHA256 十六进制值>。使用完整 signing_secret 对 时间戳 + "." + 原始请求体 验签，接受 5 分钟时间窗并采用恒定时间比较；先验签再解析 JSON，并持久化事件 ID 去重。将自己的后续操作入队后返回 HTTP 2xx。通知不会自动启动调查。

运行保护：每账户滚动 24 小时最多入队 1,000 条信号，延迟超过 24 小时的事件不补发。这是新异动发布后的通知，不是产品流量实时监测。

验证签名 · Node.js
HMAC-SHA256
import { createHmac, timingSafeEqual } from "node:crypto";

// rawBody must be the original Buffer, before JSON parsing.
export function verifySigpik(rawBody, signature, secret) {
  const match = /^t=(\d{1,12}),v1=([a-f0-9]{64})$/.exec(signature ?? "");
  if (!match) return false;
  const [, timestamp, hex] = match;
  if (Math.abs(Date.now() / 1000 - Number(timestamp)) > 300) return false;
  const expected = createHmac("sha256", secret)
    .update(timestamp + ".").update(rawBody).digest();
  return timingSafeEqual(expected, Buffer.from(hex, "hex"));
}
支持的信号事件
traffic_breakout

流量快速增长
最近一个月的访问量明显高于此前水平，而且增长规模足够大，值得关注。

traffic_acceleration

流量增长加快
连续几个统计周期保持增长，最近的增幅还在扩大。

traffic_deceleration

流量增长放缓
访问量可能仍在增长，但最近几个统计周期的增幅正在缩小。

entered_category_top_10

进入赛道前 10
该产品最近进入所属主要赛道的前 10 名。

entered_category_top_20

进入赛道前 20
该产品最近进入所属主要赛道的前 20 名。

dropped_out_of_category_top_10

跌出赛道前 10
该产品最近跌出所属主要赛道的前 10 名。

market_share_shift

赛道流量占比变化
该产品在所属赛道中的流量占比明显上升或下降。

ai_referral_breakout

AI 引荐流量快速增长
来自 AI 助手的访问量明显高于此前水平。

ai_traffic_share_shift

AI 引荐流量占比变化
AI 助手带来的流量，在整体访问量中的占比明显上升或下降。

new_ai_referral_source

新增 AI 引荐来源
产品开始从一个此前未出现的 AI 平台获得访问量。

ai_referral_sources_diversified

AI 引荐来源增加
正在为产品带来访问量的 AI 平台明显增多。

backlink_discovered

新增外链
采集到新出现的外部页面链接，可查看来源与首次发现时间。数量为采集样本，不代表全部外链或增长加速。

backlink_acquisition_spike

外链异常增长
近期新增外链或来源网站的数量，明显高于可比历史周期的水平。

ai_directory_push

集中收录到 AI 目录站
近期被多个已核实的 AI 目录站收录。

media_review_burst

媒体与评测曝光增加
近期新增了多篇媒体报道或产品评测。

google_ads_started

开始投放 Google Ads
此前没有检测到投放，近期开始出现 Google Ads 广告。

ad_creative_expansion

广告素材明显增加
近期使用的广告素材数量明显增加。

new_feature

推出新功能
产品官方发布了此前没有的新功能。

new_model

发布新模型
产品官方发布了一个新模型。

api_added

新增 API 支持
产品官网开始提供 API。

mcp_added

新增 MCP 支持
产品官网开始提供 MCP 接入。

positioning_shift

产品定位调整
官网首页对产品定位或核心卖点的表述发生明显变化。

product_launch

产品正式发布
官方渠道宣布该产品正式发布。

website_sitemap_expansion

Sitemap 页面明显增加
公开 Sitemap 中可索引 URL 的数量明显增加。

website_sitemap_contraction

Sitemap 页面明显减少
公开 Sitemap 中可索引 URL 的数量明显减少。

programmatic_seo_expansion

Sitemap 结构化 URL 批量增加
可比 Sitemap 中同类结构 URL 净增；不代表搜索引擎已收录或获得自然流量。

organic_keyword_breakout

非品牌关键词流量增长
两个月都在跟踪的同一非品牌词估算流量明显增加。

brand_search_growth

品牌搜索量增长
两个月都在跟踪的品牌关键词搜索量增加。

new_market_pages

新增一批市场页面
可比 Sitemap 新增一批语言、地区或使用场景路径 URL；不据此判定首次进入该市场。

chrome_user_growth

Chrome 扩展用户增长
Chrome 扩展的用户数量明显增长。

primary_domain_changed

更换主域名
产品官网已经迁移到新的主域名。

product_discontinued

产品停止提供
官方渠道已确认该产品停止提供。

所需权限 webhooks:manage

请求参数

字段 / 类型说明与约束
url
string必选body

详见返回示例与完整 Schema。

maxLength: 2048
locale
enum可选body

返回语言：en 或 zh-CN。

default: "en" · en | zh-CN
signal_types
array必选body

需要订阅的信号类型，仅匹配已关注的产品。

返回字段9
字段 / 类型说明与约束
id
string必选response

详见返回示例与完整 Schema。

url
string必选response

详见返回示例与完整 Schema。

status
enum必选response

详见返回示例与完整 Schema。

pending | active | paused | deleted
locale
enum必选response

返回语言：en 或 zh-CN。

en | zh-CN
signal_types
array必选response

需要订阅的信号类型，仅匹配已关注的产品。

failure_count
integer必选response

详见返回示例与完整 Schema。

created_at
string必选response

详见返回示例与完整 Schema。

updated_at
string必选response

详见返回示例与完整 Schema。

signing_secret
string可选response

详见返回示例与完整 Schema。

请求示例
POST/alerts/webhooks
curl "https://sigpik.com/api/v1/alerts/webhooks" -X POST \
  -H "Authorization: Bearer $SIGPIK_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{"url":"https://your-domain.com/webhooks/sigpik","locale":"en","signal_types":["traffic_breakout"]}'

本地模拟 · 数据仅作示例，不发送请求、不消耗额度。

201 Created响应示例 · 节选JSON
{
  "id": "wh_b46b2db0-8a30-4d69-a33e-8b5b4509c279",
  "url": "https://your-domain.com/webhooks/sigpik",
  "status": "pending",
  "locale": "en",
  "signal_types": [
    "traffic_breakout"
  ],
  "failure_count": 0,
  "created_at": "2026-09-17T05:00:00.000Z",
  "updated_at": "2026-09-17T05:00:00.000Z",
  "signing_secret": "whsec_EXAMPLE_ONLY"
}

公开目录

产品档案

GET/api/v1/tools/{slug}

通过规范 slug 查询产品，可用字段取决于账户权限。

公开 · 无需 API Key

请求参数

字段 / 类型说明与约束
slug
string必选path

产品或分类的规范 slug。

返回字段20
字段 / 类型说明与约束
tool_id
integer必选response

详见返回示例与完整 Schema。

canonical_slug
string必选response

详见返回示例与完整 Schema。

localized_slug
string必选response

详见返回示例与完整 Schema。

name
string必选response

详见返回示例与完整 Schema。

tagline
string | null可选response

详见返回示例与完整 Schema。

short_description
string | null可选response

详见返回示例与完整 Schema。

long_description
string | null可选response

详见返回示例与完整 Schema。

official_url
string必选response

每次请求仅提交一个公开产品官网。

pricing_model
string必选response

详见返回示例与完整 Schema。

listed_at
string必选response

详见返回示例与完整 Schema。

verification_status
string必选response

详见返回示例与完整 Schema。

staleness_status
string必选response

详见返回示例与完整 Schema。

has_free_plan
boolean必选response

详见返回示例与完整 Schema。

has_free_trial
boolean必选response

详见返回示例与完整 Schema。

has_api
boolean必选response

按是否支持 API 筛选。

has_mcp
boolean必选response

按是否支持 MCP 筛选。

requested_locale
string必选response

请求的返回语言。

resolved_locale
string必选response

实际可用的返回语言。

available_locales
array必选response

详见返回示例与完整 Schema。

categories
array必选response

详见返回示例与完整 Schema。

请求示例
GET/tools/{slug}
curl "https://sigpik.com/api/v1/tools/example-ai"

本地模拟 · 数据仅作示例，不发送请求、不消耗额度。

200 OK响应示例 · 节选JSON
{
  "tool_id": 1042,
  "canonical_slug": "example-ai",
  "localized_slug": "example-ai",
  "name": "Example AI",
  "tagline": "An illustrative AI workspace",
  "short_description": null,
  "logo_url": null,
  "official_url": "https://example.ai",
  "primary_category_slug": "productivity",
  "primary_category_name": "Productivity",
  "pricing_model": "freemium",
  "has_free_plan": true,
  "has_api": true,
  "has_mcp": false,
  "verification_status": "verified",
  "staleness_status": "fresh",
  "requested_locale": "en",
  "resolved_locale": "en",
  "available_locales": [
    "en"
  ],
  "long_description": null,
  "listed_at": "2026-09-01T00:00:00Z",
  "has_free_trial": false,
  "categories": []
}

Remote MCP

Agent 接入

POST/api/mcp

无状态 HTTPS，使用 API Key 认证，暂不支持 OAuth。每个工具需要 mcp:tools 及列出的权限。get_account_quota 返回套餐、scopes、MCP 次数、推广研报与外链额度/积分（不扣月度 MCP 次数）。免费版与 Starter 账户可创建仅含 mcp:tools 的密钥，使用基础 MCP 工具（每月分别 100 次与 1,000 次；Pro 为 REST 与 MCP 共享的 3,000 次），覆盖 get_product_overview、list_market_categories、list_product_signals、list_product_keywords（有权益时）与 get_account_quota。只有成功的工具调用计数；返回错误（含 not_found）的调用不计。list_product_signals 跟随账户信号预览/完整历史权益。list_product_keywords 需要 product.search_intelligence（Starter+）。start_backlink_research 需要 research:execute、backlinks.research 与 confirm_usage=true；get_backlink_research 与 get_promotion_investigation 也不扣月度 MCP 次数。工具发现和 ping 也不计费。

Cursor

保存到 .cursor/mcp.json，在本地替换 YOUR_API_KEY，勿将密钥提交到版本控制。

Claude Desktop

Claude Desktop 本地配置通过 mcp-remote 桥接（需要 Node.js）。写入 claude_desktop_config.json 后重启 Claude。这是第三方客户端桥接程序。

Cursor MCP mcp-remote
Remote MCPHTTPS
{
  "mcpServers": {
    "sigpik": {
      "url": "https://sigpik.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

保存到 .cursor/mcp.json，在本地替换 YOUR_API_KEY，勿将密钥提交到版本控制。

Remote MCP

Agent Skills

可安装的 Markdown Skill 教 Agent 何时、按何顺序调用 Sigpik MCP 工具。竞品抄作业请先用增长拆解 Skill。Skill 仅为指令，不授予 API 访问权限。

sigpik-growth-teardown

增长拆解 / 抄作业：概览定性 → 按主渠道分支（关键词或信号）→ 可选排行语境 → 询问后再开推广调查。
https://sigpik.com/skills/sigpik-growth-teardown/SKILL.md

情报工具

get_account_quota

读取套餐、scopes、MCP 调用额度、推广深度研报剩余次数，以及外链研究套餐次数/积分。 免费版与 Starter 的 MCP 档可用。 不计月度 MCP 次数。

mcp:tools + mcp:tools

字段 / 类型说明与约束
locale
string可选argument

返回语言：en 或 zh-CN。

default: "en" · maxLength: 20

返回 text content 与 structuredContent；工具错误设置 isError，并提供 error.code 与 error.message。

tools/call · JSON-RPC
JSON
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_account_quota",
    "arguments": {
      "locale": "en"
    }
  }
}
响应示例 · 节选
JSON-RPC
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"contract_version\":\"account-quota-v1\",\"generated_at\":\"2026-10-31T00:00:00.000Z\",\"plan\":{\"code\":\"pro\",\"charge_exempt\":false},\"scopes\":[\"mcp:tools\",\"research:read\",\"research:execute\"],\"features\":{\"promotion_research\":true,\"backlink_research\":true,\"search_intelligence\":true,\"signals_preview\":true,\"signals_full_history\":true,\"api_access\":true},\"mcp_calls\":{\"kind\":\"limited\",\"frequency\":\"month\",\"limit\":3000,\"used\":412,\"remaining\":2588,\"resets_at\":\"2026-11-01T00:00:00.000Z\",\"quota_key\":\"developer-pro-v1\",\"reason\":null},\"promotion_research\":{\"enabled\":true,\"limit\":5,\"used\":1,\"remaining\":4,\"credits\":null,\"resets_at\":\"2026-11-01T00:00:00.000Z\",\"charge_exempt\":false,\"live\":null,\"available\":true},\"backlink_research\":{\"enabled\":true,\"limit\":10,\"used\":2,\"remaining\":8,\"credits\":0,\"resets_at\":\"2026-11-01T00:00:00.000Z\",\"charge_exempt\":false,\"live\":true,\"available\":true},\"hint\":\"Call before start_promotion_investigation or start_backlink_research. This read does not consume monthly MCP call units, research allowance, or credits.\"}"
      }
    ],
    "structuredContent": {
      "contract_version": "account-quota-v1",
      "generated_at": "2026-10-31T00:00:00.000Z",
      "plan": {
        "code": "pro",
        "charge_exempt": false
      },
      "scopes": [
        "mcp:tools",
        "research:read",
        "research:execute"
      ],
      "features": {
        "promotion_research": true,
        "backlink_research": true,
        "search_intelligence": true,
        "signals_preview": true,
        "signals_full_history": true,
        "api_access": true
      },
      "mcp_calls": {
        "kind": "limited",
        "frequency": "month",
        "limit": 3000,
        "used": 412,
        "remaining": 2588,
        "resets_at": "2026-11-01T00:00:00.000Z",
        "quota_key": "developer-pro-v1",
        "reason": null
      },
      "promotion_research": {
        "enabled": true,
        "limit": 5,
        "used": 1,
        "remaining": 4,
        "credits": null,
        "resets_at": "2026-11-01T00:00:00.000Z",
        "charge_exempt": false,
        "live": null,
        "available": true
      },
      "backlink_research": {
        "enabled": true,
        "limit": 10,
        "used": 2,
        "remaining": 8,
        "credits": 0,
        "resets_at": "2026-11-01T00:00:00.000Z",
        "charge_exempt": false,
        "live": true,
        "available": true
      },
      "hint": "Call before start_promotion_investigation or start_backlink_research. This read does not consume monthly MCP call units, research allowance, or credits."
    }
  }
}

情报工具

get_product_overview

按域名或 slug 返回最新月产品摘要：身份、赛道、环比流量、当前 DR、获客渠道及 lead_channel。 免费版与 Starter 的 MCP 档可用。 成功时计 1 次 MCP 调用。

mcp:tools + mcp:tools

字段 / 类型说明与约束
domain
string可选argument

产品域名或 URL；查找前会规范化。

minLength: 1 · maxLength: 253
slug
string可选argument

产品或分类的规范 slug。

minLength: 1 · maxLength: 160
locale
string可选argument

返回语言：en 或 zh-CN。

default: "en" · maxLength: 20
trend_months
integer可选argument

traffic.trend 返回的月数（3–12，默认 6），按时间升序；与公开产品页展示的历史一致。

default: 6 · min: 3 · max: 12

返回 text content 与 structuredContent；工具错误设置 isError，并提供 error.code 与 error.message。

tools/call · JSON-RPC
JSON
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_product_overview",
    "arguments": {
      "domain": "example.ai",
      "locale": "en"
    }
  }
}
响应示例 · 节选
JSON-RPC
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"contract_version\":\"product-overview-v1\",\"generated_at\":\"2026-10-29T00:00:00.000Z\",\"product\":{\"tool_id\":1042,\"name\":\"Example AI\",\"slug\":\"example-ai\",\"domain\":\"example.ai\",\"official_url\":\"https://example.ai\",\"listed_at\":\"2026-01-01T00:00:00.000Z\",\"domain_created_at\":\"2024-06-01\",\"domain_age_months\":28,\"has_api\":true,\"has_mcp\":false,\"verification_status\":\"verified\",\"locale\":\"en\"},\"market\":{\"primary\":{\"slug\":\"productivity\",\"name\":\"Productivity\",\"parent_slug\":null,\"parent_name\":null},\"secondary\":[]},\"traffic\":{\"latest_month\":\"2026-08\",\"latest_visits\":131400,\"previous_month\":\"2026-07\",\"previous_visits\":100000,\"visits_change\":31400,\"growth_rate\":0.314,\"avg_visit_duration_seconds\":120,\"pages_per_visit\":3.2,\"bounce_rate\":0.41,\"trend\":[{\"month\":\"2026-07\",\"visits\":100000},{\"month\":\"2026-08\",\"visits\":131400}]},\"domain_authority\":{\"domain_rating\":62,\"observed_at\":\"2026-08-15\"},\"acquisition\":{\"snapshot_month\":\"2026-08\",\"channels\":[{\"channel\":\"search_organic\",\"share\":0.48,\"promotion_like\":false},{\"channel\":\"direct\",\"share\":0.31,\"promotion_like\":false},{\"channel\":\"referrals\",\"share\":0.12,\"promotion_like\":false}],\"lead_channel\":\"search_organic\",\"lead_share\":0.48,\"coverage\":\"partial\"},\"ai_visibility\":null,\"access\":{\"tier\":\"free_summary\",\"plan_code\":\"free\",\"redacted\":[\"ai_visibility\"]},\"links\":{\"product_page\":\"https://sigpik.com/tools/example-ai\",\"developers\":\"https://sigpik.com/developers\"}}"
      }
    ],
    "structuredContent": {
      "contract_version": "product-overview-v1",
      "generated_at": "2026-10-29T00:00:00.000Z",
      "product": {
        "tool_id": 1042,
        "name": "Example AI",
        "slug": "example-ai",
        "domain": "example.ai",
        "official_url": "https://example.ai",
        "listed_at": "2026-01-01T00:00:00.000Z",
        "domain_created_at": "2024-06-01",
        "domain_age_months": 28,
        "has_api": true,
        "has_mcp": false,
        "verification_status": "verified",
        "locale": "en"
      },
      "market": {
        "primary": {
          "slug": "productivity",
          "name": "Productivity",
          "parent_slug": null,
          "parent_name": null
        },
        "secondary": []
      },
      "traffic": {
        "latest_month": "2026-08",
        "latest_visits": 131400,
        "previous_month": "2026-07",
        "previous_visits": 100000,
        "visits_change": 31400,
        "growth_rate": 0.314,
        "avg_visit_duration_seconds": 120,
        "pages_per_visit": 3.2,
        "bounce_rate": 0.41,
        "trend": [
          {
            "month": "2026-07",
            "visits": 100000
          },
          {
            "month": "2026-08",
            "visits": 131400
          }
        ]
      },
      "domain_authority": {
        "domain_rating": 62,
        "observed_at": "2026-08-15"
      },
      "acquisition": {
        "snapshot_month": "2026-08",
        "channels": [
          {
            "channel": "search_organic",
            "share": 0.48,
            "promotion_like": false
          },
          {
            "channel": "direct",
            "share": 0.31,
            "promotion_like": false
          },
          {
            "channel": "referrals",
            "share": 0.12,
            "promotion_like": false
          }
        ],
        "lead_channel": "search_organic",
        "lead_share": 0.48,
        "coverage": "partial"
      },
      "ai_visibility": null,
      "access": {
        "tier": "free_summary",
        "plan_code": "free",
        "redacted": [
          "ai_visibility"
        ]
      },
      "links": {
        "product_page": "https://sigpik.com/tools/example-ai",
        "developers": "https://sigpik.com/developers"
      }
    }
  }
}

情报工具

list_market_categories

赛道分类字典。调用 rank_ai_products 前先解析规范 category slug。 免费版与 Starter 的 MCP 档可用。 成功时计 1 次 MCP 调用。

mcp:tools + mcp:tools

字段 / 类型说明与约束
locale
string可选argument

返回语言：en 或 zh-CN。

default: "en" · maxLength: 20
q
string可选argument

搜索关键词。

minLength: 1 · maxLength: 80
parent_slug
string可选argument

可选父赛道 slug，只返回该分支。

minLength: 1 · maxLength: 120
format
enum可选argument

tree（默认）或 flat；带搜索词时返回扁平匹配列表。

default: "tree" · tree | flat

返回 text content 与 structuredContent；工具错误设置 isError，并提供 error.code 与 error.message。

tools/call · JSON-RPC
JSON
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_market_categories",
    "arguments": {
      "locale": "en"
    }
  }
}
响应示例 · 节选
JSON-RPC
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"contract_version\":\"market-categories-v1\",\"generated_at\":\"2026-10-29T00:00:00.000Z\",\"locale\":\"en\",\"format\":\"tree\",\"total\":2,\"items\":[{\"slug\":\"productivity\",\"name\":\"Productivity\",\"parent_slug\":null,\"tool_count\":120,\"display_order\":10,\"children\":[{\"slug\":\"notes\",\"name\":\"Notes\",\"parent_slug\":\"productivity\",\"tool_count\":18,\"display_order\":11,\"children\":[]}]}],\"access\":{\"tier\":\"free_dictionary\",\"plan_code\":\"free\",\"redacted\":[]},\"links\":{\"markets_page\":\"https://sigpik.com/markets\",\"developers\":\"https://sigpik.com/developers\"},\"hint\":\"Use items[].slug (canonical) as rank_ai_products.category. Do not invent category strings.\"}"
      }
    ],
    "structuredContent": {
      "contract_version": "market-categories-v1",
      "generated_at": "2026-10-29T00:00:00.000Z",
      "locale": "en",
      "format": "tree",
      "total": 2,
      "items": [
        {
          "slug": "productivity",
          "name": "Productivity",
          "parent_slug": null,
          "tool_count": 120,
          "display_order": 10,
          "children": [
            {
              "slug": "notes",
              "name": "Notes",
              "parent_slug": "productivity",
              "tool_count": 18,
              "display_order": 11,
              "children": []
            }
          ]
        }
      ],
      "access": {
        "tier": "free_dictionary",
        "plan_code": "free",
        "redacted": []
      },
      "links": {
        "markets_page": "https://sigpik.com/markets",
        "developers": "https://sigpik.com/developers"
      },
      "hint": "Use items[].slug (canonical) as rank_ai_products.category. Do not invent category strings."
    }
  }
}

情报工具

list_product_signals

按域名或 slug 返回近期已确认产品信号。预览条数跟随账户信号权益。 免费版与 Starter 的 MCP 档可用。 成功时计 1 次 MCP 调用。

mcp:tools + mcp:tools

字段 / 类型说明与约束
domain
string可选argument

产品域名或 URL；查找前会规范化。

minLength: 1 · maxLength: 253
slug
string可选argument

产品或分类的规范 slug。

minLength: 1 · maxLength: 160
locale
string可选argument

返回语言：en 或 zh-CN。

default: "en" · maxLength: 20
window
enum可选argument

信号回看窗口：7d、30d 或 90d（默认 90d）。

default: "90d" · 7d | 30d | 90d
limit
integer可选argument

每页最多返回的记录数。

default: 10 · min: 1 · max: 50
family
enum可选argument

可选信号族筛选。

growth | product | distribution | search | ai_visibility | adoption | business_lifecycle
type
string可选argument

关键词分类，默认非品牌词。

minLength: 1 · maxLength: 80

返回 text content 与 structuredContent；工具错误设置 isError，并提供 error.code 与 error.message。

tools/call · JSON-RPC
JSON
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_product_signals",
    "arguments": {
      "domain": "example.ai",
      "window": "30d"
    }
  }
}
响应示例 · 节选
JSON-RPC
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"contract_version\":\"product-signals-list-v1\",\"generated_at\":\"2026-10-29T00:00:00.000Z\",\"product\":{\"tool_id\":1042,\"name\":\"Example AI\",\"slug\":\"example-ai\",\"domain\":\"example.ai\",\"locale\":\"en\"},\"window\":\"30d\",\"filters\":{\"family\":null,\"type\":null,\"limit\":10},\"total_matched\":1,\"truncated\":false,\"full_history\":false,\"preview_limit\":3,\"items\":[{\"signal_key\":\"sig_v1_example\",\"signal_type\":\"traffic_breakout\",\"family\":\"growth\",\"label\":\"Traffic breakout\",\"description\":\"Monthly traffic rose enough in both rate and scale to stand out.\",\"direction\":\"up\",\"importance_score\":82,\"observed_at\":\"2026-10-20T00:00:00.000Z\",\"period_start\":\"2026-09-01\",\"period_end\":\"2026-10-01\",\"old_value\":null,\"new_value\":null,\"magnitude\":null,\"evidence_count\":2}],\"access\":{\"tier\":\"signals_preview\",\"plan_code\":\"free\",\"redacted\":[\"signals.full_history\"]},\"links\":{\"product_page\":\"https://sigpik.com/tools/example-ai\",\"signals_page\":\"https://sigpik.com/signals\",\"developers\":\"https://sigpik.com/developers\"}}"
      }
    ],
    "structuredContent": {
      "contract_version": "product-signals-list-v1",
      "generated_at": "2026-10-29T00:00:00.000Z",
      "product": {
        "tool_id": 1042,
        "name": "Example AI",
        "slug": "example-ai",
        "domain": "example.ai",
        "locale": "en"
      },
      "window": "30d",
      "filters": {
        "family": null,
        "type": null,
        "limit": 10
      },
      "total_matched": 1,
      "truncated": false,
      "full_history": false,
      "preview_limit": 3,
      "items": [
        {
          "signal_key": "sig_v1_example",
          "signal_type": "traffic_breakout",
          "family": "growth",
          "label": "Traffic breakout",
          "description": "Monthly traffic rose enough in both rate and scale to stand out.",
          "direction": "up",
          "importance_score": 82,
          "observed_at": "2026-10-20T00:00:00.000Z",
          "period_start": "2026-09-01",
          "period_end": "2026-10-01",
          "old_value": null,
          "new_value": null,
          "magnitude": null,
          "evidence_count": 2
        }
      ],
      "access": {
        "tier": "signals_preview",
        "plan_code": "free",
        "redacted": [
          "signals.full_history"
        ]
      },
      "links": {
        "product_page": "https://sigpik.com/tools/example-ai",
        "signals_page": "https://sigpik.com/signals",
        "developers": "https://sigpik.com/developers"
      }
    }
  }
}

情报工具

list_product_keywords

按域名或 slug 返回已观测头部关键词事实。仅事实字段；需要 product.search_intelligence。 免费版与 Starter 的 MCP 档可用。 成功时计 1 次 MCP 调用。

mcp:tools + mcp:tools

字段 / 类型说明与约束
domain
string可选argument

产品域名或 URL；查找前会规范化。

minLength: 1 · maxLength: 253
slug
string可选argument

产品或分类的规范 slug。

minLength: 1 · maxLength: 160
locale
string可选argument

返回语言：en 或 zh-CN。

default: "en" · maxLength: 20
month
string可选argument

详见返回示例与完整 Schema。

pattern: ^\d{4}-\d{2}$
brand_scope
enum可选argument

详见返回示例与完整 Schema。

default: "all" · all | brand | non_brand
limit
integer可选argument

每页最多返回的记录数。

default: 20 · min: 1 · max: 50

返回 text content 与 structuredContent；工具错误设置 isError，并提供 error.code 与 error.message。

tools/call · JSON-RPC
JSON
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_product_keywords",
    "arguments": {
      "domain": "example.ai",
      "brand_scope": "non_brand",
      "limit": 10
    }
  }
}
响应示例 · 节选
JSON-RPC
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"contract_version\":\"product-keywords-list-v1\",\"generated_at\":\"2026-10-29T00:00:00.000Z\",\"product\":{\"tool_id\":1042,\"name\":\"Example AI\",\"slug\":\"example-ai\",\"domain\":\"example.ai\",\"locale\":\"en\"},\"sample\":{\"observed_month\":\"2026-09-01\",\"source_mode\":\"normalized\",\"sample_scope\":\"top_observed_keywords\",\"sample_size\":5},\"filters\":{\"month\":null,\"brand_scope\":\"all\",\"limit\":20},\"total_matched\":1,\"truncated\":false,\"items\":[{\"keyword\":\"example ai writing\",\"keyword_id\":9001,\"brand_type\":\"generic\",\"brand_confidence\":0.91,\"traffic\":1200,\"search_volume\":5400,\"position\":4,\"cpc\":1.2}],\"access\":{\"tier\":\"search_intelligence\",\"plan_code\":\"starter\",\"redacted\":[]},\"links\":{\"product_page\":\"https://sigpik.com/tools/example-ai\",\"developers\":\"https://sigpik.com/developers\"},\"hint\":\"Observed top keyword sample only (5 keywords kept for this month) — not a complete keyword universe; truncated refers to your limit, not the source cap. No competitor gap or opportunity ranking.\"}"
      }
    ],
    "structuredContent": {
      "contract_version": "product-keywords-list-v1",
      "generated_at": "2026-10-29T00:00:00.000Z",
      "product": {
        "tool_id": 1042,
        "name": "Example AI",
        "slug": "example-ai",
        "domain": "example.ai",
        "locale": "en"
      },
      "sample": {
        "observed_month": "2026-09-01",
        "source_mode": "normalized",
        "sample_scope": "top_observed_keywords",
        "sample_size": 5
      },
      "filters": {
        "month": null,
        "brand_scope": "all",
        "limit": 20
      },
      "total_matched": 1,
      "truncated": false,
      "items": [
        {
          "keyword": "example ai writing",
          "keyword_id": 9001,
          "brand_type": "generic",
          "brand_confidence": 0.91,
          "traffic": 1200,
          "search_volume": 5400,
          "position": 4,
          "cpc": 1.2
        }
      ],
      "access": {
        "tier": "search_intelligence",
        "plan_code": "starter",
        "redacted": []
      },
      "links": {
        "product_page": "https://sigpik.com/tools/example-ai",
        "developers": "https://sigpik.com/developers"
      },
      "hint": "Observed top keyword sample only (5 keywords kept for this month) — not a complete keyword universe; truncated refers to your limit, not the source cap. No competitor gap or opportunity ranking."
    }
  }
}

情报工具

rank_ai_products

比较增长、访问量、域名评分、搜索与 AI 引荐表现。 成功时计 1 次 MCP 调用。

mcp:tools + research:read

字段 / 类型说明与约束
locale
string可选argument

返回语言：en 或 zh-CN。

default: "en" · maxLength: 20
category
string可选argument

按分类 slug 筛选。

maxLength: 120
country
string可选argument

两位字母国家代码。

pattern: ^[A-Za-z]{2}$
q
string可选argument

搜索关键词。

maxLength: 80
preset
enum可选argument

详见返回示例与完整 Schema。

opportunities | trending | fastest-growing | most-visited | ai-referrals | breakouts | new-rising
sort
enum可选argument

结果排序指标。

default: "growth" · growth | gain | traffic | dr_growth | organic | ai | paid | duration
order
enum可选argument

排序方向。

default: "desc" · asc | desc
min_traffic
integer可选argument

最低观测流量。

default: 1000 · min: 0 · max: 9007199254740991
min_growth
number可选argument

最低增长比率；0.1 表示 10%。

default: 0 · min: 0 · max: 100
min_dr
number可选argument

最低域名评分。

default: 0 · min: 0 · max: 100
min_dr_gain
number可选argument

最低域名评分增量。

default: 0 · min: 0 · max: 100
max_domain_age_months
integer可选argument

最大域名月龄；0 关闭筛选。

default: 0 · min: 0 · max: 120
page
integer可选argument

页码；邀请体验固定返回第 1 页。

default: 1 · min: 1 · max: 200
limit
integer可选argument

每页最多返回的记录数。

default: 25 · min: 1 · max: 50

返回 text content 与 structuredContent；工具错误设置 isError，并提供 error.code 与 error.message。

tools/call · JSON-RPC
JSON
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "rank_ai_products",
    "arguments": {
      "sort": "growth",
      "limit": 10
    }
  }
}
响应示例 · 节选
JSON-RPC
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"dataset\":{\"methodology_version\":\"example\"},\"eligible_population\":1,\"filters\":{\"sort\":\"growth\",\"limit\":10},\"items\":[{\"rank\":1,\"tool_id\":1042,\"name\":\"Example AI\",\"slug\":\"example-ai\",\"normalized_domain\":\"example.ai\",\"primary_category_name\":\"Productivity\",\"primary_category_slug\":\"productivity\",\"latest_month\":\"2026-08\",\"previous_month\":\"2026-07\",\"latest_visits\":131400,\"previous_visits\":100000,\"visits_change\":31400,\"growth_rate\":0.314,\"domain_rating\":null,\"favicon_url\":null}],\"pagination\":{\"page\":1,\"limit\":10,\"has_more\":false},\"requested_locale\":\"en\",\"resolved_locale\":\"en\"}"
      }
    ],
    "structuredContent": {
      "dataset": {
        "methodology_version": "example"
      },
      "eligible_population": 1,
      "filters": {
        "sort": "growth",
        "limit": 10
      },
      "items": [
        {
          "rank": 1,
          "tool_id": 1042,
          "name": "Example AI",
          "slug": "example-ai",
          "normalized_domain": "example.ai",
          "primary_category_name": "Productivity",
          "primary_category_slug": "productivity",
          "latest_month": "2026-08",
          "previous_month": "2026-07",
          "latest_visits": 131400,
          "previous_visits": 100000,
          "visits_change": 31400,
          "growth_rate": 0.314,
          "domain_rating": null,
          "favicon_url": null
        }
      ],
      "pagination": {
        "page": 1,
        "limit": 10,
        "has_more": false
      },
      "requested_locale": "en",
      "resolved_locale": "en"
    }
  }
}

情报工具

start_promotion_investigation

复用详情页的推广历史调查，研究一个产品并生成报告。显式使用账户现有调查额度；重试相同请求时复用同一个 UUID。返回任务 ID，不提供全量数据导出。 成功时计 1 次 MCP 调用。

mcp:tools + research:execute

字段 / 类型说明与约束
slug
string可选argument

产品或分类的规范 slug。

minLength: 1 · maxLength: 200
domain
string可选argument

产品域名或 URL；查找前会规范化。

minLength: 1 · maxLength: 253
locale
enum可选argument

返回语言：en 或 zh-CN。

default: "en" · en | zh-CN
idempotency_key
string必选argument

UUID；重试相同产品和语言时复用，不同调查使用新值。

pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
confirm_usage
enum必选argument

必须为 true，明确确认使用现有调查额度。

true

返回 text content 与 structuredContent；工具错误设置 isError，并提供 error.code 与 error.message。

tools/call · JSON-RPC
JSON
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "start_promotion_investigation",
    "arguments": {
      "slug": "example-ai",
      "locale": "en",
      "idempotency_key": "b46b2db0-8a30-4d69-a33e-8b5b4509c279",
      "confirm_usage": true
    }
  }
}
响应示例 · 节选
JSON-RPC
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"task_id\":\"task_b46b2db0-8a30-4d69-a33e-8b5b4509c279\",\"type\":\"promotion_investigation\",\"status\":\"queued\",\"stage\":\"queued\",\"created_at\":\"2026-09-17T05:00:00.000Z\",\"updated_at\":\"2026-09-17T05:00:00.000Z\",\"completed_at\":null,\"status_url\":\"/api/v1/research/promotion-investigations/task_b46b2db0-8a30-4d69-a33e-8b5b4509c279\",\"result_url\":null,\"poll_after_seconds\":60,\"error\":null,\"report\":null}"
      }
    ],
    "structuredContent": {
      "task_id": "task_b46b2db0-8a30-4d69-a33e-8b5b4509c279",
      "type": "promotion_investigation",
      "status": "queued",
      "stage": "queued",
      "created_at": "2026-09-17T05:00:00.000Z",
      "updated_at": "2026-09-17T05:00:00.000Z",
      "completed_at": null,
      "status_url": "/api/v1/research/promotion-investigations/task_b46b2db0-8a30-4d69-a33e-8b5b4509c279",
      "result_url": null,
      "poll_after_seconds": 60,
      "error": null,
      "report": null
    }
  }
}

情报工具

get_promotion_investigation

一次读取调查进度与最终报告。queued/running 时 report 为 null，succeeded 时包含完整报告；failed/cancelled 为终态。查询不扣调查额度和 API 月度次数，月度次数用完仍可查。等待期间按 60 秒间隔轮询，未知或其他账户 ID 返回 404。 不计月度 MCP 次数。

mcp:tools + research:read

字段 / 类型说明与约束
task_id
string必选argument

提交后返回的随机任务 ID。

pattern: ^task_[0-9a-f-]{36}$

返回 text content 与 structuredContent；工具错误设置 isError，并提供 error.code 与 error.message。

tools/call · JSON-RPC
JSON
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_promotion_investigation",
    "arguments": {
      "task_id": "task_b46b2db0-8a30-4d69-a33e-8b5b4509c279"
    }
  }
}
响应示例 · 节选
JSON-RPC
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"task_id\":\"task_b46b2db0-8a30-4d69-a33e-8b5b4509c279\",\"type\":\"promotion_investigation\",\"status\":\"succeeded\",\"stage\":\"complete\",\"created_at\":\"2026-09-17T05:00:00.000Z\",\"updated_at\":\"2026-09-17T05:00:00.000Z\",\"completed_at\":\"2026-09-17T05:10:00.000Z\",\"status_url\":\"/api/v1/research/promotion-investigations/task_b46b2db0-8a30-4d69-a33e-8b5b4509c279\",\"result_url\":\"/api/v1/research/promotion-investigations/task_b46b2db0-8a30-4d69-a33e-8b5b4509c279\",\"poll_after_seconds\":null,\"error\":null,\"report\":{\"version\":\"example\",\"generated_at\":\"2026-09-17T05:10:00.000Z\",\"narrative\":{\"title\":\"Example promotion history\",\"summary\":{\"text\":\"Illustrative report: published sources describe a launch and later community activity.\",\"citations\":[]},\"sections\":[],\"limitations\":\"Illustrative response. Actual reports include only available evidence.\"},\"summary\":{\"actionEvidenceCount\":0,\"channelCount\":0,\"contextLeadCount\":0,\"sourceCount\":0,\"unresolvedActionCount\":0},\"analysis\":{\"overview\":\"Illustrative report.\",\"method\":\"\",\"observations\":[],\"phases\":[],\"channels\":[],\"openQuestions\":[]},\"timeline\":[],\"strategies\":[],\"sources\":[],\"context_leads\":[],\"conclusion\":\"Observed promotion does not establish growth causality.\",\"limitations\":[\"Examples are not live research results.\"],\"caveat\":\"Coverage depends on available public evidence.\",\"reliability\":{\"actorAttribution\":\"unknown\",\"coverageLevel\":\"limited\",\"growthCausality\":\"not_established\",\"growthImpact\":\"unknown\"},\"omitted_action_count\":0,\"omitted_context_count\":0}}"
      }
    ],
    "structuredContent": {
      "task_id": "task_b46b2db0-8a30-4d69-a33e-8b5b4509c279",
      "type": "promotion_investigation",
      "status": "succeeded",
      "stage": "complete",
      "created_at": "2026-09-17T05:00:00.000Z",
      "updated_at": "2026-09-17T05:00:00.000Z",
      "completed_at": "2026-09-17T05:10:00.000Z",
      "status_url": "/api/v1/research/promotion-investigations/task_b46b2db0-8a30-4d69-a33e-8b5b4509c279",
      "result_url": "/api/v1/research/promotion-investigations/task_b46b2db0-8a30-4d69-a33e-8b5b4509c279",
      "poll_after_seconds": null,
      "error": null,
      "report": {
        "version": "example",
        "generated_at": "2026-09-17T05:10:00.000Z",
        "narrative": {
          "title": "Example promotion history",
          "summary": {
            "text": "Illustrative report: published sources describe a launch and later community activity.",
            "citations": []
          },
          "sections": [],
          "limitations": "Illustrative response. Actual reports include only available evidence."
        },
        "summary": {
          "actionEvidenceCount": 0,
          "channelCount": 0,
          "contextLeadCount": 0,
          "sourceCount": 0,
          "unresolvedActionCount": 0
        },
        "analysis": {
          "overview": "Illustrative report.",
          "method": "",
          "observations": [],
          "phases": [],
          "channels": [],
          "openQuestions": []
        },
        "timeline": [],
        "strategies": [],
        "sources": [],
        "context_leads": [],
        "conclusion": "Observed promotion does not establish growth causality.",
        "limitations": [
          "Examples are not live research results."
        ],
        "caveat": "Coverage depends on available public evidence.",
        "reliability": {
          "actorAttribution": "unknown",
          "coverageLevel": "limited",
          "growthCausality": "not_established",
          "growthImpact": "unknown"
        },
        "omitted_action_count": 0,
        "omitted_context_count": 0
      }
    }
  }
}

TypeScript / Python

客户端接入

Node.js 可直接使用 fetch；Python 请先安装 httpx。鉴权请求应在服务端执行，从环境变量读取 SIGPIK_API_KEY。

复制所需端点的 TypeScript 或 Python 示例，也可使用 OpenAPI 文档生成类型化客户端。

Node.js fetch Python httpx
获取开发者权限