{"schema_version":"gendangzou-capabilities-v1","contract_version":"gendangzou-api-v2","capability":{"id":"company.research.detail","domain":"company","title":"获取公司研究档案概览","summary":"默认读取公司的最新已发布研究版本及五类事实覆盖；研究版本独立于日报快照。","intents":["get_company_research","inspect_company_facts"],"path":"/api/gendangzou/companies/{stock_code}/research","snapshot_bound":false,"compact_supported":false,"method":"GET","detail_url":"/api/gendangzou/capabilities/company.research.detail","parameters":["stock_code","research_as_of","version_id"],"response_fields":["stock_code","available","profile"],"related_capabilities":["company.research.versions.list","company.research.facts.list","company.detail"],"freshness":"quality_gated_company_research_publication","pagination":false,"documentation_url":"https://docs.mobiusquant.ai/zh/gendangzou/capabilities/company.research.detail","agent_hints":{"reuse_snapshot_id_for_follow_up":false,"fetch_evidence_on_demand":true},"request":{"parameters":[{"name":"stock_code","in":"path","required":true,"schema":{"pattern":"^[0-9]{6}$","type":"string"}},{"name":"research_as_of","in":"query","required":false,"schema":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"description":"Return the latest company research version on or before this date"}},{"name":"version_id","in":"query","required":false,"schema":{"anyOf":[{"maxLength":128,"minLength":8,"type":"string"},{"type":"null"}],"default":null}}]},"response":{"model":"CompanyResearchDetailResponse","top_level_fields":[{"name":"stock_code","required":true},{"name":"available","required":true},{"name":"profile","required":false}],"schema":{"properties":{"stock_code":{"title":"Stock Code","type":"string"},"available":{"title":"Available","type":"boolean"},"profile":{"anyOf":[{"$ref":"#/$defs/CompanyResearchProfile"},{"type":"null"}],"default":null}},"required":["stock_code","available"],"title":"CompanyResearchDetailResponse","type":"object","$defs":{"CompanyResearchProfile":{"properties":{"version_id":{"title":"Version Id","type":"string"},"version_number":{"default":1,"title":"Version Number","type":"integer"},"published_at":{"title":"Published At","type":"string"},"previous_version_id":{"default":"","title":"Previous Version Id","type":"string"},"change_summary":{"$ref":"#/$defs/CompanyResearchChangeSummary"},"stock_code":{"title":"Stock Code","type":"string"},"company_name":{"title":"Company Name","type":"string"},"research_as_of":{"title":"Research As Of","type":"string"},"completeness_status":{"const":"complete","default":"complete","title":"Completeness Status","type":"string"},"fact_count":{"default":0,"title":"Fact Count","type":"integer"},"relationship_count":{"default":0,"title":"Relationship Count","type":"integer"},"evidence_count":{"default":0,"title":"Evidence Count","type":"integer"},"material_count":{"default":0,"title":"Material Count","type":"integer"},"categories":{"items":{"$ref":"#/$defs/CompanyResearchCategorySummary"},"title":"Categories","type":"array"}},"required":["version_id","published_at","stock_code","company_name","research_as_of"],"title":"CompanyResearchProfile","type":"object"},"CompanyResearchCategorySummary":{"properties":{"category":{"enum":["ownership_control","policy_support","financing_debt","capital_use","business_projects"],"title":"Category","type":"string"},"label":{"title":"Label","type":"string"},"domains":{"items":{"type":"string"},"title":"Domains","type":"array"},"fact_count":{"default":0,"title":"Fact Count","type":"integer"},"relationship_count":{"default":0,"title":"Relationship Count","type":"integer"},"evidence_count":{"default":0,"title":"Evidence Count","type":"integer"},"material_count":{"default":0,"title":"Material Count","type":"integer"},"latest_fact_date":{"default":"","title":"Latest Fact Date","type":"string"},"average_confidence":{"default":0.0,"title":"Average Confidence","type":"number"}},"required":["category","label"],"title":"CompanyResearchCategorySummary","type":"object"},"CompanyResearchChangeSummary":{"properties":{"initial_version":{"default":false,"title":"Initial Version","type":"boolean"},"facts_added":{"default":0,"title":"Facts Added","type":"integer"},"facts_removed":{"default":0,"title":"Facts Removed","type":"integer"},"relationships_added":{"default":0,"title":"Relationships Added","type":"integer"},"relationships_removed":{"default":0,"title":"Relationships Removed","type":"integer"},"materials_added":{"default":0,"title":"Materials Added","type":"integer"},"materials_removed":{"default":0,"title":"Materials Removed","type":"integer"},"gaps_opened":{"default":0,"title":"Gaps Opened","type":"integer"},"gaps_resolved":{"default":0,"title":"Gaps Resolved","type":"integer"},"changed_domains":{"items":{"type":"string"},"title":"Changed Domains","type":"array"}},"title":"CompanyResearchChangeSummary","type":"object"}}}}}}