mx-stocks-screener

name

mx-stocks-screener

description

基于东方财富数据库，支持通过自然语言输入筛选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.

选股 / 选板块 / 选基金

通过自然语言查询进行选股，数据来自于妙想大模型服务，支持以下类型：

• A股、港股、美股
• 基金、ETF、可转债、板块

功能范围

基础选股能力

• 按股价、市值、涨跌幅、市盈率等财务/行情指标筛选
• 按技术信号筛选（如连续上涨、突破均线等）
• 按主营业务、主要产品筛选
• 按行业/概念板块筛选成分股
• 获取指数成分股
• 推荐股票、基金、板块
• 按多种复合条件（如且、或、非、排序等）的逻辑组合筛选

A股进阶查询（部分场景）

除基础选股外，还支持A股上市公司的以下查询场景：

• 高管信息、股东信息
• 龙虎榜数据
• 分红、并购、增发、回购
• 主营区域
• 券商金股

注意：上述仅为部分示例，实际支持的条件远多于列举内容

查询示例

类型	query	select-type
选A股	股价大于500元的股票、创业板市盈率最低的50只	A股
选港股	港股的科技龙头	港股
选美股	纳斯达克市值前30、苹果产业链美股	美股
选板块	今天涨幅最大板块	板块
选基金	白酒主题基金、新能源混合基金近一年收益排名	基金
选ETF	规模超2亿的电力ETF	ETF
选可转债	价格低于110元、溢价率超5个点的可转债	可转债

快速开始

1. 命令行调用

python3 {baseDir}/scripts/get_data.py --query 股价大于100元，主力流入，成交额排名前50 --select-type A股

输出示例

CSV: /path/to/miaoxiang/mx_stocks_screener/mx_stocks_screener_9535fe18.csv
描述: /path/to/miaoxiang/mx_stocks_screener/mx_stocks_screener_9535fe18_description.txt
行数: 42

参数说明：

参数	说明	必填
--query	自然语言查询条件	✅
--select-type	查询领域	✅

2. 代码调用

import asyncio
from pathlib import Path
from scripts.get_data import query_mx_stocks_screener

async def main():
    result = await query_mx_stocks_screener(
        query="A股半导体板块市值前20",
        selectType="A股",
        output_dir=Path("miaoxiang/mx_stocks_screener"),
    )
    if "error" in result:
        print(result["error"])
    else:
        print(result["csv_path"], result["row_count"])

asyncio.run(main())

输出文件说明

文件	说明
mx_stocks_screener_<查询ID>.csv	全量数据表，列名为中文（由返回的 columns 映射），UTF-8 编码，可用 Excel 或 pandas 打开
mx_stocks_screener_<查询ID>_description.txt	数据说明：查询内容、行数、列名说明等

环境变量

变量	说明	默认
MX_STOCKS_SCREENER_OUTPUT_DIR	CSV 与描述文件的输出目录（可选）	miaoxiang/mx_stocks_screener

常见问题

如何指定输出目录？

export MX_STOCKS_SCREENER_OUTPUT_DIR="/path/to/output"
python3 {baseDir}/scripts/get_data.py --query "查询内容" --select-type "查询领域"