stock-watcher

📈 A股自选股智能管家

编辑精选

基于同花顺T2级数据源的A股自选股管理工具,支持沪深及科创板实时行情追踪,为投资者提供本地化、低延迟的个性化股票监控服务。

收藏
7.3k
安装
2.1k
版本
v1.0.0
CLS 安全性认证2026-04-30
点击查看完整报告 >

使用说明

核心用法

Stock Watcher 是一款面向中国A股市场的个人自选股管理工具,核心功能围绕「观察列表」展开。用户可通过6位数字股票代码完成添加、删除、列出、清空等基础管理操作,并一键获取全列表的行情摘要。数据层直接对接同花顺(10jqka.com.cn)公开股票页面,无需API密钥,即装即用。安装脚本会自动初始化 ~/.clawdbot/stock_watcher// 目录,所有自选股以明文格式存储于本地 watchlist.txt,便于用户随时审计或手动编辑。

显著优点

1. 零配置上手:无需注册、无付费墙,依托同花顺公开数据,开箱即用。
2. 本地化优先:所有列表数据仅存本地,隐私风险极低;卸载脚本可彻底清理残留。

3. 请求行为克制:内置1秒/次的频率控制与10秒超时,对数据源友好,降低被封禁概率。

4. 模块化架构:add、remove、list、clear、summarize 五大脚本独立,配合统一 config.py,便于二次开发或CI集成。

潜在缺点与局限性

  • 数据延迟:行情存在1-3分钟延迟,不适合高频交易或毫秒级决策场景。
  • 解析脆弱性:当前采用正则表达式解析HTML,若同花顺改版可能导致摘要功能失效。
  • 市场覆盖有限:仅支持沪深A股及科创板,港股、美股、北交所等未纳入。
  • 输入校验薄弱:股票代码格式验证可绕过,无效代码会产生无效网络请求。
  • 无历史数据:仅展示最新行情,不提供K线、财务指标等深度分析。

适合的目标群体

  • 散户投资者:需要轻量级、无广告的自选股跟踪,替代券商APP的繁杂信息流。
  • 量化入门者:可将本Skill作为数据抓取教学案例,或作为自动化工作流的触发器。
  • 多账户管理者:通过本地文件同步,实现跨设备、跨平台的统一股票池管理。
  • 隐私敏感用户:拒绝将持仓信息上传至云端第三方服务。

使用风险

  • 数据源单点故障:完全依赖同花顺网站可用性,若对方反爬升级或维护,服务将中断。
  • 网络环境依赖:无离线缓存机制,断网即无法获取行情。
  • 性能瓶颈:当自选股数量超过50只时,串行请求可能导致摘要生成耗时过长(50秒+)。
  • 合规边界:虽仅抓取公开数据,但需关注同花顺Robots协议及当地金融监管对自动化数据获取的最新规定。

安全解读

核心用法

Stock Watcher 是一款面向 A 股投资者的轻量级自选股管理工具,集成于 Clawdbot 生态。用户可通过六位数字代码管理沪深主板及科创板的股票监控列表,支持添加、删除、列表查看、清空及行情摘要五大核心操作。

典型使用场景

  • 快速建立个人关注股票池(如 600053 九鼎投资、688785 恒运昌)
  • 一键获取全仓股票的涨跌幅概览与详情链接
  • 本地持久化存储于 ~/.clawdbot/stock_watcher/watchlist.txt

数据源:完全依赖同花顺(10jqka.com.cn)的公开股票页面,通过 HTTP GET 请求抓取实时行情与资金流向数据。

显著优点

1. 功能聚焦无冗余:仅做一件事——自选股管理,不涉及交易、荐股等高风险功能
2. 数据权威可靠:同花顺为国内头部金融信息服务商,A 股数据覆盖完整

3. 隐私设计克制:仅收集用户主动输入的六位股票代码,不触碰持仓、账户等敏感信息

4. 本地化存储:自选列表以纯文本形式存放于用户目录,用户完全掌控数据主权

5. 合规通过率高:通过 GDPR 数据最小化、CCPA 知情权、TLS 传输等六项合规检查

潜在缺点与局限性

| 维度 | 具体问题 | 影响程度 |
|:---|:---|:---|
| **数据时效** | 行情存在 1-3 分钟延迟 | 中 — 不适合高频交易决策 |
| **依赖管理** | 缺少 requirements.txt,requests/bs4 版本未锁定 | 低 — 可能导致环境不一致 |
| **输入验证** | 股票代码未强制校验 6 位数字格式 | 低 — 依赖 BeautifulSoup 容错 |
| **错误透明性** | 网络异常静默处理,无日志输出 | 低 — 增加调试难度 |
| **数据源风险** | 同花顺页面结构变更将导致爬虫失效 | 中 — 需人工维护适配 |
| **市场局限** | 仅支持 A 股(沪/深/科创),不含港股、美股 | 中 — 跨市场投资者需另寻工具 |

适合人群

  • 散户投资者:需要简易工具跟踪 5-20 只核心持仓的日常波动
  • 量化学习者:可作为数据采集脚本的入门参考实现
  • 隐私敏感用户:拒绝券商 App 过度权限索取,偏好本地化方案

常规风险

  • 市场风险:工具仅提供数据展示,不提供投资建议,用户需自主承担投资决策后果
  • 技术风险:第三方数据源稳定性不可控,建议每月验证数据抓取有效性
  • 运维风险:个人开发者维护(T3 来源),长期更新承诺存疑,建议 fork 后自建维护

stock-watcher 内容

scripts文件夹
手动下载zip · 8.8 kB
add_stock.pytext/plain
请选择文件