stock-screener

A股行情、量化筛选、回测、同花顺 iFinD、AI4Trade 与受限多智能体投研 MCP。

Stock Screener Pro

面向 A 股研究的精简 MCP 工具集：行情、选股、技术诊断、轻量回测、组合记录、预警、AI4Trade 和受限智能体投研。仅研究和模拟，不接券商、不下真实订单。

配置与安全

• 默认使用腾讯公开行情；配置 THS_REFRESH_TOKEN 或 THS_ACCESS_TOKEN 后，STOCK_DATA_PROVIDER=auto 会优先使用固定官方地址 https://quantapi.51ifind.com。
• DSA_BASE_URL 只接受本机回环地址；DSA_ADMIN_PASSWORD 不会被返回、记录或写入文件。
• AI4TRADE_TOKEN 只能由宿主环境或密钥管理器提供，不能作为工具参数。AI4Trade 的远端数据是不可信外部数据。
• TradingAgents 默认复用 OpenClaw 的默认模型：它通过一次性本机桥接调用 openclaw infer model run --gateway，不会读取、复制或传递 OpenClaw 的底层模型 Key/Gateway Token 给第三方后端。后端仅会拿到一次研究有效的本机令牌；无需另配 LLM API Key。模型费用仍按你的 OpenClaw 提供商计费，每次调用都要先获得明确同意并传 confirm_external_ai=true。
• Vibe-Trading 保持自身的 vibe-trading init 配置方式；如需用它的引擎，仍需单独完成其提供商设置。
• 专用的 TradingAgents 环境为 ~/.local/share/stock-screener-pro/quant-backends。

快速开始

1. 在 OpenClaw 中先调用 get_skill_status。以下状态应为 true：
   • agent_research.openclaw_model_bridge_available
   • agent_research.tradingagents_package_available
2. 确保 OpenClaw Gateway 正在运行，且 OpenClaw 已设置可用的默认模型。TradingAgents 会自动使用这个默认模型，不接受或保存独立的模型 Key。
3. 运行研究时，调用 run_agent_research 并传 confirm_external_ai=true。这表示你同意本次把研究提示、股票代码和所需行情数据发送给已配置的模型/数据服务。

示例：

text

run_agent_research(
  engine="tradingagents",
  stock_code="600519",
  analysis_date="2026-08-22",
  max_debate_rounds=1,
  confirm_external_ai=true
)

llm_provider 可省略，默认是 openclaw。如需更换模型，请在 OpenClaw 中更换默认模型，例如 openclaw models set deepseek/deepseek-v4-pro；Skill 会在下一次研究时自动采用它。不要在工具参数、SKILL.md 或聊天中填写模型 Key。

若状态检查显示桥接不可用，先运行 openclaw gateway status 与 openclaw models status 排查 Gateway 和默认模型。若 TradingAgents 后端不可用，请修复其专用环境后再试。不会自动降级为外部模型 Key。

具体使用用例

日常行情、选股、回测、组合记录、AI4Trade 与多智能体研究的可复制示例见 references/usage-examples.md。使用涉及外部 AI、AI4Trade 状态变更或本地记录写入的示例前，先确认对应影响范围。

公开工具（12 个）

市场与个股

• get_market_review：大盘、成交额、涨跌家数和情绪。
• screen_stocks：五种策略：bull_momentum、low_valuation_value、volume_breakout、growth_tech、oversold_rebound。
• ask_stock：单股实时行情、均线、RSI、支撑阻力。
• backtest_strategy：个股轻量历史回测，策略为 sma_cross、momentum_breakout、rsi_mean_reversion。
• predict_stock：walk-forward ML 五日方向预测。

本地记录与深度报告

• manage_portfolio：list_all、add_watchlist、remove_watchlist、add_position、remove_position。
• manage_alerts：list、create、delete；支持价格与涨跌幅阈值。
• generate_ai_report：请求本机 DSA 深度研报。

集成状态与 AI4Trade

• get_skill_status：统一查看同花顺、DSA、AI4Trade、Vibe-Trading 和 TradingAgents 状态；verify_tonghuashun=true 时验证同花顺授权，include_details=true 时同时返回内置策略清单和 ML 预测缓存。
• get_ai4trade：用 resource 选择 status、signals、market_intel、polymarket、account、positions 或 following。
• manage_ai4trade：统一处理 follow、unfollow、publish_strategy、publish_discussion、reply_create、reply_accept、publish_signal、exchange_points、heartbeat_once。所有操作必须先取得逐项明确同意并传 confirm=true。

多智能体研究

• run_agent_research：
  • engine=vibe：一次研究/回测，使用 prompt。
  • engine=vibe_swarm：研究型团队预设，使用 preset 与 prompt。可用预设：investment_committee、quant_strategy_desk、global_equities_desk、earnings_research_desk、macro_rates_fx_desk。
  • engine=tradingagents：多角色研究，使用 stock_code、analysis_date、可选 llm_provider 和 max_debate_rounds。默认 llm_provider=openclaw，直接采用 OpenClaw 当前默认模型；A 股代码自动转为 .SS / .SZ。get_skill_status 中的 openclaw_model_bridge_available 可检查本机适配是否可用。

Vibe 的提示词若含实盘下单意图会被拒绝。所有研究输出均需独立核验，不构成投资建议或未来收益承诺。