腾讯自选股金融数据查询工具
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @tencent-adm/westock-data。
技能介绍
具体问题
在金融数据分析或应用开发中,获取结构化市场数据是常见但繁琐的需求。开发者需要从腾讯自选股等数据源查询股票行情、财务报表、资金流向等信息,用于构建分析模型、监控仪表盘或回测交易策略。直接对接原始 API 可能涉及复杂的鉴权、格式解析和稳定性问题,而手动从网页抓取数据则效率低下且易受网站变动影响。
工作原理
腾讯自选股金融数据查询技能封装了底层数据接口,通过标准化的命令行工具提供服务。其核心流程围绕以下关键步骤:
- 代码检索:使用
search命令根据名称或关键词定位资产代码。默认类型为stock,可通过--type参数明确指定搜索etf、index、sector、bond、futures或forex。例如,search 宁德时代用于查找股票,search 沪深300 --type etf用于查找 ETF。注意:search命令不支持代码批量查询。 - 数据获取:针对不同数据维度,使用对应命令进行查询。常见的核心命令包括
finance(财务数据)、kline(历史K线)、report(公告报表)和fund flow(资金流向)。关键能力是支持批量操作:除search外,其他命令通常支持将多个股票代码用逗号分隔在同一条命令中执行,例如finance sh600519,sz000651。 - 并发优化:为了提高效率,技能强调并发执行。当需要执行多个无依赖的查询(如同时获取行情、财报和资金流)时,应将它们组织在同一轮工具调用中并行发出,而不是顺序等待前一个结果返回。
- 结果与异常处理:工具会返回结构化的数据或明确的错误信息。遇到空结果时,需根据返回信息判断是代码不支持还是特定时间点无数据披露。技能要求如实转述失败信息,严禁编造数据或转而使用
web_search等替代方案。
适用边界与注意点
该技能专注于金融数据查询,但在使用时必须遵守以下铁律和限制:
- 数据非实时:
kline等命令返回的数据可能存在延迟。在任何展示中,都必须明确标注数据日期,避免使用“现价”、“实时涨跌”等误导性表述。 - 货币单位精确:查询港股、美股时,数据单位分别为港元/美元和美元。输出中严禁使用人民币符号
¥。 - 批量规则严格:进行多股票对比分析时,应始终使用支持批量的命令并一次性传入所有代码。禁止在同一分析中混合使用批量命令和单股拆分命令。唯一例外是
search命令,它只接受单个关键词。 - 能力范围明确:技能主要覆盖个股、ETF、指数、板块等市场数据。对于 GDP、CPI、PMI 等宏观数据,必须使用专门的
macro indicator命令,不能绕过。 - 搜索智能但有限:
search在空结果时会根据原意最多再尝试一种资产类型,但不会对同一关键词进行多种类型的连续盲试。最终无结果应直接告知用户。 - 合规性声明:所有数据来源于腾讯自选股接口,仅供参考,不构成任何投资建议。开发者需在应用中加入必要的风险提示。
使用场景
- 量化策略开发者需要批量获取多只A股、港股的历史K线与资金流向数据,用于本地回测模型的因子构建与信号验证。
- 财务研究员或投资分析师需要快速检索并对比多家上市公司的最新财务报表核心指标,以完成横向比较研究。
- 个人投资者或财经博主在分析个股时,需要先通过股票名称搜索到正确的交易代码,然后查询其历史行情和公告信息。
- 数据工程师需要构建一个数据管道,定时从该技能拉取特定指数、ETF的实时行情与基金数据,更新至内部数据库。
适合人员
- 量化策略开发者:需要为回测系统获取干净、标准化的多市场金融时序数据。
- 基本面分析师/研究员:需要高效获取并对比上市公司的财务报表与经营数据,以支撑投资决策。
- 财经内容创作者:需要引用准确的历史行情与数据来撰写分析文章或制作视频内容。
- 金融科技公司的数据工程师:需要构建稳定可靠的数据采集模块,为上层应用提供金融数据API。