{"skill":{"slug":"mx-stocks-screener","displayName":"Intelligent Stocks Screener","summary":"基于东方财富数据库，支持通过自然语言输入筛选A港美股、基金、债券等多种资产，支持多元指标筛选，含技术面、消息面、基本面及市场情绪等，可用于全球资产速筛、跨市场监控、投资组合构建、策略回测等场景。返回结果包含数据说明及 csv 文件。Natural language screener for investment...","description":"---\nname: mx-stocks-screener\ndescription: 基于东方财富数据库，支持通过自然语言输入筛选A港美股、基金、债券等多种资产，支持多元指标筛选，含技术面、消息面、基本面及市场情绪等，可用于全球资产速筛、跨市场监控、投资组合构建、策略回测等场景。返回结果包含数据说明及 csv 文件。Natural language screener for investment assets across global markets, including A-shares, ETFs, bonds, HK and US stocks, and funds. It enables multi-dimensional filtering via technical, fundamental, sentiment and news indicators. Ideal for global asset selection, cross-market monitoring, portfolio construction and strategy backtesting.\nmetadata:\n  {\n    \"openclaw\": {\n      \"requires\": {\n        \"env\":[\"EM_API_KEY\"]\n      },\n      \"install\": [\n        {\n          \"id\": \"pip-deps\",\n          \"kind\": \"python\",\n          \"package\": \"httpx\",\n          \"label\": \"Install Python dependencies\"\n        }\n      ]\n    }\n  }\n---\n\n# 选股 / 选板块 / 选基金\n\n通过**自然语言查询**进行选股，数据来自于妙想大模型服务，支持以下类型：\n- **A股**、**港股**、**美股**\n- **基金**、**ETF**、**可转债**、**板块**\n\n## 密钥来源与安全说明\n\n- 本技能仅使用一个环境变量：`EM_API_KEY`。\n- `EM_API_KEY` 由东方财富妙想服务（`https://ai.eastmoney.com/mxClaw`）签发，用于其接口鉴权。\n- 在提供密钥前，请先确认密钥来源、可用范围、有效期及是否支持重置/撤销。\n- 禁止在代码、提示词、日志或输出文件中硬编码/明文暴露密钥。\n\n## 功能范围\n\n### 基础选股能力\n- 按股价、市值、涨跌幅、市盈率等**财务/行情指标**筛选\n- 按**技术信号**筛选（如连续上涨、突破均线等）\n- 按**主营业务、主要产品**筛选\n- 按**行业/概念板块**筛选成分股\n- 获取**指数成分股**\n- **推荐**股票、基金、板块\n- 按多种**复合条件**（如且、或、非、排序等）的逻辑组合筛选\n\n### A股进阶查询（部分场景）\n除基础选股外，还支持A股上市公司的以下查询场景：\n- 高管信息、股东信息\n- 龙虎榜数据\n- 分红、并购、增发、回购\n- 主营区域\n- 券商金股\n\n> **注意**：上述仅为部分示例，实际支持的条件远多于列举内容\n\n### **查询示例**\n\n| 类型     | query                    | select-type |\n|----------|--------------------------|----------|\n| 选A股   | 股价大于500元的股票、创业板市盈率最低的50只 | A股 |\n| 选港股   | 港股的科技龙头                  | 港股 |\n| 选美股   | 纳斯达克市值前30、苹果产业链美股   | 美股 |\n| 选板块   | 今天涨幅最大板块                 | 板块 |\n| 选基金   | 白酒主题基金、新能源混合基金近一年收益排名 | 基金 |\n| 选ETF   | 规模超2亿的电力ETF              | ETF |\n| 选可转债 | 价格低于110元、溢价率超5个点的可转债 | 可转债 |\n\n## 前提条件\n\n### 1. 注册东方财富妙想账号\n\n访问 https://ai.eastmoney.com/mxClaw 注册账号并获取API_KEY。\n\n### 2. 配置 Token\n\n```bash\n# macOS 添加到 ~/.zshrc，Linux 添加到 ~/.bashrc\nexport EM_API_KEY=\"your_api_key_here\"\n```\n\n然后根据系统执行对应的命令：\n\n**macOS：**\n```bash\nsource ~/.zshrc\n```\n\n**Linux：**\n```bash\nsource ~/.bashrc\n```\n\n### 3. 安装依赖\n\n\n```bash\npip3 install httpx --user\n```\n\n## 快速开始\n\n### 1. 命令行调用\n\n```bash\npython3 {baseDir}/scripts/get_data.py --query 股价大于100元，主力流入，成交额排名前50 --select-type A股\n```\n\n**输出示例**\n```\nCSV: /path/to/miaoxiang/mx_stocks_screener/mx_stocks_screener_9535fe18.csv\n描述: /path/to/miaoxiang/mx_stocks_screener/mx_stocks_screener_9535fe18_description.txt\n行数: 42\n```\n\n**参数说明：**\n\n| 参数 | 说明 | 必填 |\n|------|------|------|\n| `--query` | 自然语言查询条件 | ✅ |\n| `--select-type` | 查询领域 | ✅ |\n\n### 2. 代码调用\n\n```python\nimport asyncio\nfrom pathlib import Path\nfrom scripts.get_data import query_mx_stocks_screener\n\nasync def main():\n    result = await query_mx_stocks_screener(\n        query=\"A股半导体板块市值前20\",\n        selectType=\"A股\",\n        output_dir=Path(\"miaoxiang/mx_stocks_screener\"),\n    )\n    if \"error\" in result:\n        print(result[\"error\"])\n    else:\n        print(result[\"csv_path\"], result[\"row_count\"])\n\nasyncio.run(main())\n```\n\n## 输出文件说明\n\n| 文件 | 说明 |\n|------|------|\n| `mx_stocks_screener_<查询ID>.csv` | 全量数据表，列名为**中文**（由返回的 columns 映射），UTF-8 编码，可用 Excel 或 pandas 打开 |\n| `mx_stocks_screener_<查询ID>_description.txt` | 数据说明：查询内容、行数、列名说明等 |\n\n## 环境变量\n\n| 变量                        | 说明                    | 默认 |\n|---------------------------|-----------------------|------|\n| `MX_STOCKS_SCREENER_OUTPUT_DIR` | CSV 与描述文件的输出目录（可选）    | `miaoxiang/mx_stocks_screener` |\n| `EM_API_KEY` | 妙想智能选股工具 API 密钥（必备） | 无 |\n\n## 常见问题\n\n**错误：请设置 EM_API_KEY 环境变量**\n\n- 请访问 https://ai.eastmoney.com/mxClaw 获取`API_KEY`。\n- 配置`EM_API_KEY`环境变量\n\n\n**如何指定输出目录？**\n```bash\nexport MX_STOCKS_SCREENER_OUTPUT_DIR=\"/path/to/output\"\npython3 {baseDir}/scripts/get_data.py --query \"查询内容\" --select-type \"查询领域\"\n```","tags":{"latest":"1.0.15","Ashare":"1.0.8","Stock":"1.0.8","financial":"1.0.8","portfolio":"1.0.8","quant":"1.0.8","trade":"1.0.8"},"stats":{"comments":0,"downloads":24484,"installsAllTime":47,"installsCurrent":47,"stars":101,"versions":16},"createdAt":1773389567370,"updatedAt":1778491876821},"latestVersion":{"version":"1.0.15","createdAt":1776424764495,"changelog":"Publish 1.0.15","license":"MIT-0"},"metadata":{"setup":[{"key":"EM_API_KEY","required":true}],"os":null,"systems":null},"owner":{"handle":"financial-ai-analyst","userId":"s172qfps754dhtdynwv0gwshes83mtd4","displayName":"Financial AI Analyst","image":"https://avatars.githubusercontent.com/u/41098207?v=4"},"moderation":null}