Open API · v1

黑客松情报开放 API

我们在站点内持续多源抓取黑客松与赛事情报（HackHQ、观猹 watcha.cn，持续扩充），你用一把 API Key 即可在你的产品、机器人或 Agent 里查询全量赛事库。同一把 Key 同时支持 REST 与 MCP 两种协议。

注册并获取 Key OpenAPI 规范

三步接入

① 获取 Key：注册登录后，在控制台 → MCP 中心创建 API Key（格式 po_sk_...）。
② 带鉴权调用：请求头携带 Authorization: Bearer po_sk_... 或 X-API-Key。
③ 消费数据：查询情报列表/详情/统计；Pro 可触发在线抓取，把最新情报推进你的应用。

诚实原则随 API 交付：返回的是原始情报（非已核验赛历），截止日期可能被来源解析错——请在你的产品里提示终端用户核对官方页面。我们不承诺获奖概率。

curl "https://your-domain.com/api/open/v1/events?format=online&limit=5" \
  -H "Authorization: Bearer po_sk_xxxxxxxx"

端点参考

方法	路径	说明
GET	/api/open/v1/events	查询情报列表（关键词/形式/来源/截止区间/分页）
GET	/api/open/v1/events/{id}	单条赛事详情
GET	/api/open/v1/stats	赛事库概览：总量/来源分布/7 天内截止数/最近抓取时间
POST	/api/open/v1/radar/refresh	触发一次多源在线抓取（仅 Pro，5 分钟节流）
GET	/api/open/v1/openapi.json	OpenAPI 3.1 规范（无需鉴权，可直接导入 Apifox/Postman）

完整参数与响应结构见 OpenAPI 3.1 规范（可导入 Apifox / Postman / Insomnia）。

配额

方案	每日请求	单页上限	在线抓取
Free	500 / 天	10 条	—
Pro	20,000 / 天	100 条	✓（5 分钟节流）

配额按 UTC+8 自然日重置；响应头 X-RateLimit-Remaining 返回剩余量。

错误码

HTTP	code	含义
401	UNAUTHORIZED	Key 缺失/无效/已吊销
403	PRO_REQUIRED	该端点需要 Pro
429	QUOTA_EXCEEDED	当日配额用尽
429	TOO_FREQUENT	抓取节流中（5 分钟一次）

所有错误统一为 { success: false, error: { code, message } }。

MCP 接入（AI 助手形态）

同一能力也以 MCP 服务器交付——把七阶段工作流的 13 个工具（情报抓取/罗盘评分/规则拆解/闭环规划/UI 配方/路演骨架/冲刺清单/复盘）接进 zcode、Claude、Cursor 等 MCP 客户端。与 REST 共用同一把 Key、同一套配额。

· 托管 HTTP：粘贴下方配置即可，无需本地安装
· 本地 stdio：npx -y prizeops-mcp 薄客户端转发
· 工具清单与文档见控制台 → MCP 中心

{
  "mcpServers": {
    "prizeops": {
      "type": "http",
      "url": "https://your-domain.com/api/mcp",
      "headers": { "Authorization": "Bearer po_sk_xxxxxxxx" }
    }
  }
}

通过 Skill 接入（无可视化界面）

不想用可视化界面？让 Agent 替你接入

把下面的提示词复制给你的 AI 助手（zcode / Claude Code / Cursor…），它将通过 SkillPay 完成购买、安装与验证

请通过 SkillPay 购买并安装 Skill「prize-ops」。
官方安装与购买说明： https://skillpay.alipay.com/userguide.md 请先阅读官方说明、核验来源，并完成指南中的skillpay-onboarding安装：npx -y @alipay/agent-payment@latest install-skill --skill-name skillpay-onboarding
安装成功后，读取新安装的 skillpay-onboarding 的 SKILL.md，再按其说明购买并安装商户 2088242381104751的P0806000212833567。
我已授权安装依赖和发起购买；需要登录授权或付款时，请提供官方链接或二维码，由我本人确认，不要替我确认。确认成功后，请继续完成商品安装和验证。

提示词已内置安全边界：安装依赖与发起购买由 Agent 执行，登录授权与付款由你本人确认——与我们的「人工确认边界」纪律一致。

把黑客松情报接进你的产品。

一把 Key，REST + MCP 双协议。免费档每天 500 次调用，够跑通所有验证。

免费注册领取 Key