{"openapi":"3.1.0","info":{"title":"Metatinker Public Research Knowledge API","version":"2.0.0","description":"公开只读的 AI 研究、日度信号、研究 DEMO 和知识图谱查询接口。"},"servers":[{"url":"https://metatinker.cn"}],"tags":[{"name":"Discovery"},{"name":"Research"},{"name":"Daily"},{"name":"Projects"},{"name":"Knowledge"}],"paths":{"/.well-known/metatinker-agent.json":{"get":{"tags":["Discovery"],"summary":"读取 Agent 发现文档","responses":{"200":{"description":"Discovery manifest"}}}},"/api/v2/status":{"get":{"tags":["Discovery"],"summary":"读取公开内容状态","responses":{"200":{"description":"Status envelope","content":{"application/json":{"schema":{"type":"object","required":["data","meta","errors"],"properties":{"data":{},"meta":{"type":"object","required":["schema_version","generated_at","timezone","source_revision","request_id"],"properties":{"schema_version":{"type":"string"},"generated_at":{"type":"string","format":"date-time"},"timezone":{"type":"string"},"source_revision":{"type":"string"},"request_id":{"type":"string"}}},"errors":{"type":"array","items":{"type":"object"}}}}}}}}}},"/api/v2/search":{"get":{"tags":["Discovery"],"summary":"搜索公开内容","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2}},{"name":"type","in":"query","schema":{"type":"string","enum":["research","project","daily"]}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":20}}],"responses":{"200":{"description":"Search result envelope","content":{"application/json":{"schema":{"type":"object","required":["data","meta","errors"],"properties":{"data":{},"meta":{"type":"object","required":["schema_version","generated_at","timezone","source_revision","request_id"],"properties":{"schema_version":{"type":"string"},"generated_at":{"type":"string","format":"date-time"},"timezone":{"type":"string"},"source_revision":{"type":"string"},"request_id":{"type":"string"}}},"errors":{"type":"array","items":{"type":"object"}}}}}}},"400":{"description":"Invalid query"}}}},"/api/v2/research":{"get":{"tags":["Research"],"summary":"列出深度研究","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"cursor","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Research index envelope","content":{"application/json":{"schema":{"type":"object","required":["data","meta","errors"],"properties":{"data":{},"meta":{"type":"object","required":["schema_version","generated_at","timezone","source_revision","request_id"],"properties":{"schema_version":{"type":"string"},"generated_at":{"type":"string","format":"date-time"},"timezone":{"type":"string"},"source_revision":{"type":"string"},"request_id":{"type":"string"}}},"errors":{"type":"array","items":{"type":"object"}}}}}}}}}},"/api/v2/research/{slug}":{"get":{"tags":["Research"],"summary":"读取深度研究详情","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Research detail envelope","content":{"application/json":{"schema":{"type":"object","required":["data","meta","errors"],"properties":{"data":{},"meta":{"type":"object","required":["schema_version","generated_at","timezone","source_revision","request_id"],"properties":{"schema_version":{"type":"string"},"generated_at":{"type":"string","format":"date-time"},"timezone":{"type":"string"},"source_revision":{"type":"string"},"request_id":{"type":"string"}}},"errors":{"type":"array","items":{"type":"object"}}}}}}},"404":{"description":"Not found"}}}},"/api/v2/daily":{"get":{"tags":["Daily"],"summary":"列出日度信号快照","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"cursor","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Daily index envelope","content":{"application/json":{"schema":{"type":"object","required":["data","meta","errors"],"properties":{"data":{},"meta":{"type":"object","required":["schema_version","generated_at","timezone","source_revision","request_id"],"properties":{"schema_version":{"type":"string"},"generated_at":{"type":"string","format":"date-time"},"timezone":{"type":"string"},"source_revision":{"type":"string"},"request_id":{"type":"string"}}},"errors":{"type":"array","items":{"type":"object"}}}}}}}}}},"/api/v2/daily/latest":{"get":{"tags":["Daily"],"summary":"读取最新日度信号快照","responses":{"200":{"description":"Latest daily envelope","content":{"application/json":{"schema":{"type":"object","required":["data","meta","errors"],"properties":{"data":{},"meta":{"type":"object","required":["schema_version","generated_at","timezone","source_revision","request_id"],"properties":{"schema_version":{"type":"string"},"generated_at":{"type":"string","format":"date-time"},"timezone":{"type":"string"},"source_revision":{"type":"string"},"request_id":{"type":"string"}}},"errors":{"type":"array","items":{"type":"object"}}}}}}},"404":{"description":"No published daily snapshot"}}}},"/api/v2/daily/{date}":{"get":{"tags":["Daily"],"summary":"读取指定日期的日度信号快照","parameters":[{"name":"date","in":"path","required":true,"schema":{"type":"string","format":"date"}}],"responses":{"200":{"description":"Daily detail envelope","content":{"application/json":{"schema":{"type":"object","required":["data","meta","errors"],"properties":{"data":{},"meta":{"type":"object","required":["schema_version","generated_at","timezone","source_revision","request_id"],"properties":{"schema_version":{"type":"string"},"generated_at":{"type":"string","format":"date-time"},"timezone":{"type":"string"},"source_revision":{"type":"string"},"request_id":{"type":"string"}}},"errors":{"type":"array","items":{"type":"object"}}}}}}},"404":{"description":"Not found"}}}},"/api/v2/projects":{"get":{"tags":["Projects"],"summary":"列出研究 DEMO 与产品原型","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"cursor","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Project index envelope","content":{"application/json":{"schema":{"type":"object","required":["data","meta","errors"],"properties":{"data":{},"meta":{"type":"object","required":["schema_version","generated_at","timezone","source_revision","request_id"],"properties":{"schema_version":{"type":"string"},"generated_at":{"type":"string","format":"date-time"},"timezone":{"type":"string"},"source_revision":{"type":"string"},"request_id":{"type":"string"}}},"errors":{"type":"array","items":{"type":"object"}}}}}}}}}},"/api/v2/projects/{slug}":{"get":{"tags":["Projects"],"summary":"读取研究 DEMO 详情","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Project detail envelope","content":{"application/json":{"schema":{"type":"object","required":["data","meta","errors"],"properties":{"data":{},"meta":{"type":"object","required":["schema_version","generated_at","timezone","source_revision","request_id"],"properties":{"schema_version":{"type":"string"},"generated_at":{"type":"string","format":"date-time"},"timezone":{"type":"string"},"source_revision":{"type":"string"},"request_id":{"type":"string"}}},"errors":{"type":"array","items":{"type":"object"}}}}}}},"404":{"description":"Not found"}}}},"/api/v2/knowledge/graph":{"get":{"tags":["Knowledge"],"summary":"查询公开知识图谱","parameters":[{"name":"focus","in":"query","schema":{"type":"string"}},{"name":"depth","in":"query","schema":{"type":"integer","minimum":0,"maximum":2,"default":1}},{"name":"types","in":"query","description":"逗号分隔的节点类型。","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":300,"default":150}}],"responses":{"200":{"description":"Knowledge graph envelope","content":{"application/json":{"schema":{"type":"object","required":["data","meta","errors"],"properties":{"data":{},"meta":{"type":"object","required":["schema_version","generated_at","timezone","source_revision","request_id"],"properties":{"schema_version":{"type":"string"},"generated_at":{"type":"string","format":"date-time"},"timezone":{"type":"string"},"source_revision":{"type":"string"},"request_id":{"type":"string"}}},"errors":{"type":"array","items":{"type":"object"}}}}}}},"400":{"description":"Invalid query"},"404":{"description":"Focus node not found"}}}}}}