📦 Stock Screener — 股票智能筛选

# Stock Filter Skills 股票多条件筛选、热门因子管理、Jiuyan 数据查询和抖音热点分析。 当用户提到股票筛选、股票搜索、股票详情、股票对比、批量查询、股票分析、热门因子、因子预设、jiuyan/韭研、抖音热点等话题时，使用本技能。 ## 安装 安装依赖： ``bash cd {baseDir} && npm install ` 需要配置以下环境变量（在 OpenClaw config 中设置 skills.entries.stock-filter-skills.env）： - STOCK_API_BASE_URL: API 服务地址（必填） - STOCK_API_KEY: API 认证密钥（必填，联系后端管理员申请） - STOCK_API_TIMEOUT: 请求超时秒数（可选，默认 30） ## 使用方式 所有工具通过 CLI 调用，格式为： `bash node src/main.js '' ` 无参数的工具直接调用： `bash node src/main.js ` 工作目录必须为 {baseDir}。 ## 工具列表 ### 股票筛选模块 stock_filter — 多条件筛选股票，支持分页排序 `bash node src/main.js stock_filter '{"filters": {"market": ["sh"]}, "page": 1, "page_size": 20, "sort_field": "pe", "sort_order": "asc"}' ` 参数: filters(object, 筛选条件), page(int, 页码), page_size(int, 每页数量), sort_field(string, 排序字段), sort_order(string, asc/desc) stock_filter_options — 获取所有可用筛选维度和选项（无参数） `bash node src/main.js stock_filter_options ` 使用 stock_filter 前应先调用本工具了解有哪些维度可用。 stock_search — 按关键词搜索股票 `bash node src/main.js stock_search '{"keyword": "贵州茅台", "limit": 10}' ` 参数: keyword(string, 必填, 搜索关键词), limit(int, 可选, 返回上限默认10) stock_detail — 获取股票详细指标（PE/PB/ROE/毛利率/负债率/营收/净利润/大单/概念板块） `bash node src/main.js stock_detail '{"code": "600519"}' ` 参数: code(string, 必填, 股票代码) stock_detail_batch — 批量获取多只股票详情，并发请求提高效率 `bash node src/main.js stock_detail_batch '{"codes": ["600519", "000858", "000333"]}' ` 参数: codes(array, 必填, 股票代码列表) 需要同时查看多只股票时使用本工具，比逐个调用 stock_detail 更高效。单只股票失败不影响其他结果。 stock_compare — 对比多只股票的指标，可指定对比字段 `bash node src/main.js stock_compare '{"codes": ["600519", "000858"], "fields": ["pe", "pb", "roe", "gross_margin"]}' ` 参数: codes(array, 必填, 股票代码列表), fields(array, 可选, 对比字段列表) 不传 fields 则返回所有指标。传入 fields 时仅返回指定字段的对比数据，结果更精简易读。 ### 热门因子模块 hot_factor_list — 获取因子预设列表（无参数） `bash node src/main.js hot_factor_list ` hot_factor_create — 创建因子预设 `bash node src/main.js hot_factor_create '{"name": "成长股筛选", "factors": ["roe_high", "revenue_growth"]}' ` 参数: name(string, 必填, 预设名称), factors(array, 必填, 因子ID列表) hot_factor_update — 更新因子预设 `bash node src/main.js hot_factor_update '{"preset_id": "xxx", "name": "新名称"}' ` 参数: preset_id(string, 必填), name(string, 可选), factors(array, 可选) hot_factor_delete — 删除因子预设（不可恢复） `bash node src/main.js hot_factor_delete '{"preset_id": "xxx"}' ` 参数: preset_id(string, 必填) hot_factor_use — 使用预设并增加计数 `bash node src/main.js hot_factor_use '{"preset_id": "xxx"}' ` 参数: preset_id(string, 必填) hot_factor_sort — 调整预设排序 `bash node src/main.js hot_factor_sort '{"preset_ids": ["id1", "id2", "id3"]}' ` 参数: preset_ids(array, 必填, 按期望顺序排列的ID列表) ### Jiuyan 数据模块 jiuyan_stock_analysis — 获取股票综合分析 `bash node src/main.js jiuyan_stock_analysis '{"stock_code": "300236"}' ` 参数: stock_code(string, 必填, 股票代码) jiuyan_stock_theme — 获取股票主题/题材数据 `bash node src/main.js jiuyan_stock_theme '{"stock_code": "300236"}' ` 参数: stock_code(string, 必填, 股票代码) jiuyan_articles — 批量获取文章详情 `bash node src/main.js jiuyan_articles '{"article_ids": "id1,id2,id3"}' ` 参数: article_ids(string, 必填, 逗号分隔的文章ID) ### 抖音热点模块 douyin_hotspot_list — 获取抖音热点列表 `bash node src/main.js douyin_hotspot_list '{"page": 1, "page_size": 20}' ` 参数: page(int, 可选, 默认1), page_size(int, 可选, 默认20) douyin_hotspot_detail — 获取热点详情 `bash node src/main.js douyin_hotspot_detail '{"aweme_id": "xxx"}' ` 参数: aweme_id(string, 必填, 热点ID) ## 错误处理 所有工具返回 JSON。错误时格式为 {"error": "描述"}`。常见错误：认证失败（检查 API Key）、连接失败（检查服务是否启动）、参数错误。 ## 典型使用流程 1. 筛选股票：先 stock_filter_options 获取维度 → 再 stock_filter 执行筛选 2. 查股票：stock_search 搜索 → stock_detail 查详情 3. 批量查询：stock_detail_batch 一次获取多只股票详情 4. 对比股票：stock_compare 对比多只股票的关键指标 5. 分析股票：jiuyan_stock_analysis 获取分析 → jiuyan_stock_theme 查看主题 6. 管理预设：hot_factor_list 查看 → hot_factor_create/update/delete 操作 7. 看热点：douyin_hotspot_list 浏览 → douyin_hotspot_detail 查详情