找人找资源
传一段需求，拿回候选的脱敏卡、匹配理由和「去对接」链接。
规则脱敏规则与平台一致；永不返回联系方式
申请接入这项能力能力一览
找人找资源
每张候选卡只有类型、标题、城市和匹配理由。要联系就点「去对接」，到平台托管页走正常流程。
POST /match用一句话说明你要找什么，返回最多 10 张候选卡；每张卡的 reason 是一句理由（对得上哪几项由规则判定，带 reason_ai: true 的由 AI 写成句子），connect_url 是网页链接（URL Link，不提供小程序码）。GET /connections/:code查一次对接的当前状态。
提交需求
需求直接进平台，来源标「合作方提供」和你的渠道码。
规则审核标准不因来源变
申请接入这项能力提交需求
提交后走和平台上同样的内容审核，通过才进对应板块。每个合作方每天的提交条数有上限。
POST /demands提交一条需求，审核通过后进入对应板块；每个合作方每天最多 20 条（可被调低），所属组织需已有负责人账号。
状态回调
审核结果、对方回复、同意对接、达成合作，推回你的系统。
规则签名、重试，失败可重放
申请接入这项能力状态回调
事件带签名，投递失败会按间隔重试，错过的可以在重放窗口内补推。具体事件见下面的接入文档。
供给接入
批量推项目、技术、服务和政策，审核后上架，对接产生分成。
规则来源可见，不代发在孵项目
申请接入这项能力供给接入
按你自己的编号新增、更新、下架。
POST /supply新增一条供给。PUT /supply/:external_id按你自己的编号更新一条供给。DELETE /supply/:external_id按你自己的编号下架一条供给。
智能体工具
同一套能力包装成 MCP 工具，主流 AI 应用和企业自建助手直接调用。
规则按调用方的密钥计费限流
申请接入这项能力智能体工具
工具清单见下面的「智能体接入」。
POST /mcp智能体工具入口（MCP，JSON-RPC 2.0，一次一条消息）：先 initialize，再 tools/list 看你这把密钥能用的工具；四个工具：find_people_resources 与 match_policies（各计入一次免费检索）、get_connection_status、submit_demand（必须带 user_confirmed:true）。测试密钥的回包见文档「沙箱」一节。
三步接入
- 1
申请
填单位、联系人、手机号和要接的能力。商务用你留的手机号回电，确认接入范围。不收用户数据。
- 2
沙箱调通
拿沙箱密钥，用示例数据把请求、返回和回调都跑一遍。沙箱不限次数，不计费。
- 3
切正式
审核通过后创建正式密钥，把地址和密钥换成正式的。计费从这一步开始。
调用示例
curl -X POST 'https://geekwork.cc/api/open/v1/match' \
-H 'Authorization: Bearer gk_sbx_3f9a••••••••••••c71d' \
-H 'Content-Type: application/json' \
-d '{
"need": "想找苏州的视觉质检场景",
"limit": 10
}'{
"candidates": [
{
"type": "tech_scene",
"title": "示例：工厂视觉质检试点场景",
"city": "苏州",
"verified": true,
"reason": "这是沙箱示例卡，不对应真实内容",
"connect_url": "https://geekwork.cc/c/sandbox-1"
}
]
}在线试一试
写一句需求，看返回长什么样。不用密钥，用的是固定的示例内容，不会碰真实数据。
点「试一下」，返回两张示例脱敏卡。
智能体接入
主流 AI 应用或企业自建助手，把下面四个工具配进去就能调用，同一套密钥、计费和限流。
- 找人找资源传需求，返回脱敏候选和理由
- 提交需求把需求交给平台审核
- 查对接进展看一次对接走到哪一步
- 查政策匹配按企业情况找能申请的政策
价格与规则
价格暂不公示，开放后以合同和《价格》页为准。免费检索照常。
免费
- 免费检索，结果带「由极客创孵提供」；沙箱和提交需求不占次数100次 / 天
按结果计费：对方同意对接才扣费，拒绝、超时、撤回都退回
- 预购 20 条即将开放
- 预购 50 条即将开放
- 预购 100 条即将开放
包年：对公转账到账后开通正式环境
- 单个板块授权即将开放
- 第二个板块起，每个即将开放
- 全部板块打包即将开放
调用量与超出
- 单板块每月调用50,000次 / 月
- 打包每月调用400,000次 / 月
- 超出部分即将开放
- 只返回脱敏卡，不返回联系方式
- 名片摘要本人同意才共享
- 对接一律回平台托管页
安全与隐私
返回只有脱敏卡
候选只给类型、标题、城市和匹配理由，永不返回联系方式。
同意才共享摘要
名片摘要要本人同意；回调里只有状态和他同意共享的内容。
连接回平台
发起连接一律到托管对接页，身份、额度、审核都在平台。
密钥与授权把关
密钥只显示前后四位；新建和修改授权两人把关；单家可一键止损。
接入文档
文档版本 1.0.8 https://geekwork.cc/api/open/v1
限流
- 每分钟请求
- 30 次 / 分钟
- 每日请求上限
- 5000 次 / 天
- 沙箱每分钟请求
- 60 次 / 分钟
- 被自动限流后每分钟请求
- 5 次 / 分钟
- 提交需求，每个合作方每天
- 20 条 / 天
以上是默认值，可被调低。超出回 rate_limited，按返回的 retry_at 重试。
已开放的接口
POST /match用一句话说明你要找什么，返回最多 10 张候选卡；每张卡的 reason 是一句理由（对得上哪几项由规则判定，带 reason_ai: true 的由 AI 写成句子），connect_url 是网页链接（URL Link，不提供小程序码）。POST /demands提交一条需求，审核通过后进入对应板块；每个合作方每天最多 20 条（可被调低），所属组织需已有负责人账号。GET /connections/:code查一次对接的当前状态。POST /supply新增一条供给。PUT /supply/:external_id按你自己的编号更新一条供给。DELETE /supply/:external_id按你自己的编号下架一条供给。POST /mcp智能体工具入口（MCP，JSON-RPC 2.0，一次一条消息）：先 initialize，再 tools/list 看你这把密钥能用的工具；四个工具：find_people_resources 与 match_policies（各计入一次免费检索）、get_connection_status、submit_demand（必须带 user_confirmed:true）。测试密钥的回包见文档「沙箱」一节。
对接说明
- 对接链接 connect_url 是网页链接（URL Link），在微信里点开会进小程序的对接页；V1 只提供这种链接，不提供小程序码，因为小程序码只能带 32 个字符的参数，装不下对接令牌。请把链接原样展示或转发给你的用户。
- 候选卡挑哪几张、按什么顺序，以及每张对得上哪几项（关键词命中、城市是否相符、阶段有没有写到、发布方是否实名），都由规则判定。reason 是把这几项写成的一句话：带 reason_ai: true 的那张由 AI 按这几项写成，只用卡片上本来就给你的标题、城市、实名标和你自己发来的关键词，不会多出卡片以外的信息；没有这个键的是规则模板句。资料里没有的会写「没写到」。
- 你的用户点对接链接进到托管对接页后，打招呼的开场白三选一可由 AI 起草：只用用户自己的公开名片、他在你这边写的需求（与对接页上展示的同一份）和对方卡片的公开标题，标「AI 生成 · 草稿」，用户改完确认才发出；AI 不可用时换回平台通用的三版。工作台「供给接入」上传自己格式的表格时，可由 AI 把列名对到平台字段，文字原样照抄你的表格，联系人、电话等个人信息列整列不收，站长逐列核对后才去预检。
- GET /ledger/companies（台账读取）即将开放：现在调用回 not_open（HTTP 501），开放前不能申请这项能力。
即将开放的接口即将开放
这些接口还没有注册，不能申请，也调不通。
GET /ledger/companies即将开放：读取孵化器自用台账里的企业列表（孵化器自用）；开放前调用回 not_open（HTTP 501）。
对接状态说明
initiated- 已发出，等对方回应；占用 1 次对接次数（冻结）
agreed- 对方同意对接；扣减 1 次对接次数
declined- 对方婉拒；冻结的次数退回
expired- 超过对方回应时限没有处理，含对方注销；冻结的次数退回
withdrawn- 发起人撤回；同意之前撤回的次数退回，同意之后撤回不退
achieved- 双方在平台确认达成合作
unbilled- 发起时对接次数余额为 0，没有占用也不计费
错误码
| 错误码 | HTTP | 说明 |
|---|---|---|
invalid_key | 401 | 密钥不存在或格式不对 |
key_revoked | 401 | 密钥已停用 |
not_active | 403 | 合作方还没开通正式环境 |
partner_paused | 403 | 合作方被暂停 |
scope_denied | 403 | 这把密钥没有该能力的范围 |
validation_failed | 400 | 请求内容不合要求 |
content_rejected | 422 | 内容没通过安全检查 |
needs_owner | 422 | 你们的组织还没有负责人账号，提交的需求没有地方归属，请先联系我们补上 |
rate_limited | 429 | 请求太快，请按 retry_at 重试 |
quota_exhausted | 429 | 今日免费检索或今日需求条数已用完，按 retry_at 次日再试 |
no_balance | 402 | 对接次数余额不足 |
not_found | 404 | 没有这个对象 |
not_open | 501 | 这个接口即将开放，现在还不能调用（文档「即将开放」一节列着） |
platform_paused | 503 | 开放接口临时维护中 |
internal | 500 | 服务端出错，请带上 request_id 联系我们 |
回调事件
合作方可订阅：demand.reviewedconnection.repliedconnection.agreedconnection.closedconnection.achievedsupply.reviewedconnection.stage_changed
孵化器可订阅：application.status_changedbooking.*resource_request.*voucher.*event_signup.*commercial.stage_changed
变更记录
- 1.0.82026-10-27
新增：找人找资源（POST /match 与智能体工具 find_people_resources）候选卡的 reason 可由 AI 写成句子，这样的卡多一个字段 reason_ai: true。挑哪几张、对得上哪几项仍由规则判定，AI 只用卡片上本来就给你的标题、城市、实名标和你发来的关键词，资料里没有的写「没写到」，不会出现卡片以外的信息和联系方式；AI 不可用时自动换回规则模板句，不带 reason_ai。
- 1.0.72026-10-26
更正与补充：沙箱示例卡增至 30 张；测试密钥提交需求回的编号改为 dmd_test_ 开头；GET /ledger/companies 即将开放，现在调用回 not_open（HTTP 501），不再回 not_found；写明对接链接只提供网页链接（URL Link），不提供小程序码；写明候选卡的 reason 按规则生成。
- 1.0.62026-10-26
变更（合作方都还没有上线，直接改）：提交需求（POST /demands 与智能体工具 submit_demand）的需求类型 kind 改为 purchase、pilot、channel，与平台发布表单的需求类型同一组取值，不再接受 procure；需求说明 detail 的上限由 1000 字改为 120 字（与发布表单的需求说明同上限，表单调整时这里跟着变），title 仍是 4 到 40 字；不合要求回 validation_failed，invalid 里列出字段。新增：智能体工具 POST /mcp 四个工具（find_people_resources、submit_demand、get_connection_status、match_policies）全部开放，submit_demand 必须带 user_confirmed:true；文档新增「沙箱」一节，说明测试密钥下四个工具回什么（示例数据，不计费、不写库、不占免费检索次数）；沙箱里固定有一条示例对接 c_sandbox_0001（状态 initiated，不会变化），GET /connections/c_sandbox_0001 与工具 get_connection_status 都查得到；智能体工具 find_people_resources 的文字说明里每张候选卡带各自的对接链接，与结构化结果里的 connect_url 是同一条。
- 1.0.52026-10-26
变更：供给接入的必填项与可选值改为跟平台发布表单一致：技术场景（tech_scene）现在要填 title、summary、city、coopModes、budgetBand，needKind 改为选填；单选/多选字段的取值必须取自发布表单的选项，传了表单里没有的值会被拒收并列出可选值；企业服务（marketing）暂不支持接入，提交会回「这个板块暂不支持接入」。错误体新增 invalid：missing 只列没填的字段，invalid 列填了但取值不对的字段。
- 1.0.42026-10-26
新增：供给接入三个接口（新增、按你自己的编号更新、下架）开放，申请时可勾选「供给接入」范围；审核通过或未通过各发一次 supply.reviewed 事件；测试密钥只校验不入库。
- 1.0.32026-10-25
补充：提交需求、查对接状态各有一个调用示例；文档里给出限流数值（每分钟、每日、沙箱、被自动限流后、每日需求条数）。
- 1.0.22026-10-25
更正：文档与可申请能力只列已开放的接口（找人找资源、提交需求、查对接状态）以及回调与事件订阅；供给接入、台账读取、智能体工具改列「即将开放」，开放前不能申请。
- 1.0.12026-10-24
补充：对接状态说明（expired 含对方注销）；提交需求每个合作方每天有条数上限（可被调低），所属组织没有负责人账号时回 needs_owner；找人找资源的候选卡在受保护板块多一个 stage 字段（阶段档）。
- 1.0.02026-10-24
首次公开：找人找资源、提交需求、回调、智能体工具、供给接入、事件订阅、台账读取。
接口有版本，旧版本至少保留 6 个月。