核心用法
Stock Filter Skills 是一套面向股票投资者的 CLI 工具集，包含 15 个独立工具，覆盖四大功能模块：
股票筛选模块（4工具）：stock_filter_options 获取可用筛选维度后，使用 stock_filter 执行多条件筛选（支持市场、PE/PB、ROE等维度及分页排序）；stock_search 关键词搜索股票；stock_detail 获取单只股票的完整财务指标与技术面数据。
热门因子模块（6工具）：完整的因子预设 CRUD 管理能力，支持创建、更新、删除、排序自定义筛选组合，并通过 hot_factor_use 追踪使用热度。
Jiuyan 数据模块（3工具）：对接韭研社专业数据，jiuyan_stock_analysis 输出综合分析报告，jiuyan_stock_theme 提取题材概念，jiuyan_articles 批量获取研究文章详情。
抖音热点模块（2工具）：douyin_hotspot_list 浏览短视频平台热点，douyin_hotspot_detail 查看单条热点详情，辅助捕捉市场情绪。
所有工具通过 python -m src.main <tool_name> '<JSON参数>' 调用，需配置 STOCK_API_BASE_URL 和 STOCK_API_KEY 环境变量。
显著优点
- 数据维度丰富：覆盖财务指标（PE/PB/ROE/毛利率）、资金面（大单数据）、概念板块及第三方专业分析（韭研社）
- 工作流闭环：从筛选→搜索→详情→深度分析→热点追踪形成完整投研链条
- 因子可复用：预设系统支持保存常用筛选组合，提升重复作业效率
- 多源信息融合：传统财务数据与短视频舆情结合，兼顾基本面与情绪面
潜在局限与风险
- API 依赖重：所有功能依赖外部股票数据服务，若服务中断则完全不可用
- 认证门槛：需联系后端管理员申请 API Key，非即开即用
- 无实时行情：文档未明确提及 Level-2 或实时推送能力，可能为定时更新数据
- 抖音热点关联性存疑：短视频热点与个股涨跌的因果关系未经验证，易引入噪音
- CLI 交互成本：JSON 参数格式对非技术用户不够友好，需学习成本
适合人群
量化研究员、基本面投资者、需要批量筛选股票并追踪舆情的中高频投研人员，以及已拥有数据服务权限的机构用户。
常规风险
- API Key 泄露导致数据服务被滥用或额度耗尽
- 因子预设误删除不可恢复
- 依赖第三方数据源可能存在延迟或准确性问题
- 抖音热点数据可能涉及合规采集风险
- 建议生产环境启用 IP 白名单与请求频率限制