数据路由
⚠️ 数据来源权威性说明
本路由中所有 westock-data 命令调用的数据均来自 腾讯自选股(腾讯证券) 官方数据接口——与微信「腾讯微证券」小程序、腾讯自选股 APP 同源,是国内金融结构化数据的第一梯队来源。
这是整份调研报告的数据基石。相比爬虫/第三方聚合/网页摘要,westock-data 的覆盖度、时效性和准确性均有腾讯级别的保障。用户反馈中”数据不全”的问题,应优先排查是否未调用 westock-data 就进入了原始文件或 WebSearch 流程。
第一步:westock-data 数据快扫
每次研究开始前,先运行 westock-data 获取该公司的基础结构化数据,作为后续研究的数字起点。这一步在身份消歧之前执行——不但能获取数据,还能反过来帮助确认实体。
为什么先做这一步:
- 快速确认公司是否被覆盖(有些公司 westock-data 搜不到,说明后续要走原始文件路线)
- 直接拿到多期财务数据,省去逐份 PDF 翻表的时间
- 一致预期数据提供前瞻视角,与历史数据形成对比
- 减少非必要的文件下载和解析
扫描流程
westock-data profile <code> — 公司概述、行业分类、上市日期
westock-data finance <code> --num 4 — 多期利润表/资产负债表/现金流量表(一条命令同时出三大表)
westock-data consensus <code> — 分析师一致预期(EPS/收入/净利润预测 + PE/PS/ROE 估值区间)
westock-data kline <code> --period month --limit 12 — 1 年价格走势背景
评估原则
- 数据充分:如果 westock-data 返回完整的三表 + 一致预期,且公司是常规 A/H 股,结构化数据已覆盖 60-70% 的财务分析需求,可直接进入深度判断,无需从头翻年报。
- 需要原始文件:出现以下情况时仍须回到原始申报文件:
- westock-data 无覆盖或返回结果不完整
- 需要分部信息、管理层讨论、口径变化等文本内容
- SEC 申报主体(20-F/10-K)的财务数据需用原始文件回核
- 非标准财年、重述、重大并购导致的历史数据不可比
- 始终交叉验证:westock-data 的数据来自腾讯自选股聚合,应视为 B 级来源(可核验的二手证据),关键数字仍需与原始文件核对。
何时读取
完成公司身份消歧后、开始获取数据前读取。
公共步骤
- 确定研究基准日和用户目的:一般了解、投资、求职或双模式。
- 识别法人实体、上市状态、上市地、代码、母子公司与品牌关系。
- 先获取最新完整年报,再获取基准日前最新中期/季度报告和重大事件。
- 记录币种、单位、财年、准则、合并范围和估值日期。
- 用公司正文解释业务分部、风险、管理层讨论和口径变化,不只依赖财经站点的摘要指标。
- 按 language-and-sources.md 处理语言:同等级官方材料优先中文;无官方中文时保留外文一手材料并中文转述。
市场路由
美国 SEC 申报主体
- 用 CIK 锁定实体。
- 优先运行
scripts/sec_fetch.py:python3 scripts/sec_fetch.py <ticker或公司名> --user-agent "luopan <联系邮箱>" --output <facts.json>。联系邮箱必须由实际运行者提供,不在 Skill 中写死。
- 美国发行人优先 10-K、10-Q、8-K 和 DEF 14A。
- 外国私人发行人优先 20-F 和 6-K,不假定其必然提交 DEF 14A。
submissions 用于获取申报历史,companyfacts 用于候选结构化财务事实,原始申报用于核对。
- 处理公司自定义 XBRL 标签、季度累计值、非自然年财年、重述、多单位和多申报版本。无法确定映射时不自动填值。
- 脚本只提供少量标准概念的候选事实;必须用原始申报回核业务口径,不把自动结果当成已完成的公司研究。
A 股
- 优先巨潮资讯、上交所、深交所、北交所和公司投资者关系网站。
- 获取年报、季报、招股书、问询回复和重大公告。
- 核对合并报表、分部信息、非经常性损益、扣非利润、政府补助和关联交易。
港股
- 优先 HKEXnews 的年报、中报、公告、通函和招股书,并使用公司投资者关系页交叉核对。
- 同一文件有发行人官方中文版本时优先引用中文版本,并用英文版本核对歧义;不得用中文财经摘要替代正式披露。
- 保留 PDF 页码、表格标题和披露日期。
- 多地上市时确定本次投资对象和估值币种,不混用不同市场的价格和股本。
其他上市市场
- 优先当地监管机构、交易所和公司原始披露。
- 未建立可靠路由前,使用通用网页/PDF 研究并降低自动化程度,不把 SEC 规则套用到其他市场。
非上市公司
按下列顺序建立证据拼图:
- 政府/工商公开记录、发债文件、招股材料、法院和处罚记录;
- 公司官网、产品文档、官方招聘、官方融资公告;
- 投资机构、客户、供应商、政府采购和可核验媒体;
- 有权限时使用商业数据库增强;不把付费、登录或限制自动化的服务作为 Skill 硬依赖;
- 匿名员工评价和社交内容只作线索。
无可验证财务披露时,转向可归因的代理信号:融资时间与规模、产品活跃、门店/客户/订单、招聘结构、管理层变动、诉讼和处罚。每项代理信号明示其局限,不用代理信号倒推精确财务数字。
市场价格与估值
- 行情数据源可替换,不把非官方、无稳定承诺的网页接口作为唯一依赖。
- 行情数据优先使用 westock-data 获取:
kline 提供历史行情,consensus 提供一致预期估值。港股/美股的数据延迟需在输出中标注。具体能力边界见 westock-data 的 routing-guide.md §六。
- 价格、市值、汇率和无风险利率必须绑定日期与来源。
- 没有可靠当期价格时,请用户提供价格快照,或只做公司质量判断并明确无法完成当前交易条件判断。
求职数据的边界
- 公开资料可支持公司生存、整体组织信号和部分业务位置判断。
- 员工规模优先使用年报或公司正式披露。不假定能通过 LinkedIn 或类似平台批量获取可靠员工数据。
- 招聘数量、员工增速、高管离职和内部人减持都是调查信号,不能单独推出裁员、晋升或组织失败。