核心功能
PyWenCai 是连接 Python 与同花顺问财平台的非官方 SDK，允许用户通过中文自然语言查询多市场金融数据。核心能力包括：
- 自然语言转数据查询：输入"市盈率小于20的股票""今日MACD金叉"等口语化描述，自动解析为结构化数据
- 多市场覆盖：A股（stock）、港股（hkstock）、美股（usstock）、指数（zhishu）、基金（fund）、可转债（conbond）、期货（futures）等10+资产类别
- 批量与分页获取：支持
loop=True自动分页抓取全量数据，单页最大100条 - 灵活筛选排序：通过
sort_key/sort_order自定义排序，find参数优先返回指定代码
显著优点
1. 零门槛中文交互：无需学习SQL或专业API语法，降低量化入门门槛
2. 数据维度丰富：涵盖行情、财务指标（ROE/PE/PB）、技术指标（MACD/KDJ）、资金流向（主力/北向）、特殊事件（涨停/连板/退市）等
3. 输出标准化：直接返回 pandas DataFrame，无缝衔接数据分析流程
4. 代理与重试机制：支持request_params传入代理配置，retry参数自动失败重试
潜在局限与风险
| 问题 | 说明 |
|------|------|
| **Cookie依赖** | 必须手动从浏览器提取并定期更新，无程序化认证流程 |
| **非官方接口** | 逆向工程实现，存在服务变更导致失效的风险 |
| **频率限制** | 高频调用可能触发封禁，文档建议调用间隔≥2秒 |
| **Node.js运行时** | 内部依赖Node.js执行JS代码，增加部署复杂度 |
| **付费功能隔离** | 专业版数据需单独Cookie和`pro=True`参数，无明确计费说明 |
适用人群
- 个人量化投资者：快速验证选股因子、搭建策略回测前的标的池筛选
- 财经自媒体/分析师：批量获取结构化数据进行可视化内容生产
- 教学场景：向非技术背景用户演示"自然语言+金融数据"的交互范式
常规风险提示
- 合规风险：工具本身不违规，但获取的数据应用于实盘交易需自行承担决策责任
- 数据时效性：未明确标注数据延迟（推测为T+0或T+1行情），高频交易场景需验证
- Cookie安全：Cookie文件包含登录态，存储于环境变量或明文文件存在泄露风险，建议配合密钥管理服务