ClawKit Logo
ClawKitReliability Toolkit
Back to Registry
Official Verified

pywencai

同花顺问财自然语言数据查询工具 - 使用中文自然语言查询A股、指数、基金、港美股、可转债等市场数据。

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/coderwpf/pywencai
Or

PyWenCai(同花顺问财数据查询)

通过Python使用中文自然语言从同花顺问财查询A股及其他市场数据。

⚠️ 需要Cookie:必须提供问财网站的有效Cookie。获取方法见下文。

环境要求

  • Python 3.7+
  • Node.js v16+ (pywencai internally executes JS code)
  • pip package manager

安装

pip install pywencai --upgrade

如何获取Cookie

  1. 在浏览器中打开 https://www.iwencai.com/ 并登录。
  2. 按F12打开开发者工具 → 切换到Network标签。
  3. 在问财页面执行任意查询。
  4. 找到发往iwencai.com的请求,从请求头中复制Cookie值。
  5. 将该字符串作为cookie参数使用。

基本用法

import pywencai

# 查询今日涨幅前10的股票,需要有效cookie
res = pywencai.get(query='今日涨幅前10', cookie='your_cookie_here')
print(res)

API参考:pywencai.get(**kwargs)

必选参数

  • query — 中文自然语言查询字符串,如 '今日涨停股票''市盈率小于20的股票'
  • cookie — 从问财网站获取的Cookie字符串(必需)

可选参数

  • sort_key — 排序字段名,如 '退市@退市日期'
  • sort_order — 排序方向:'asc'(升序)或 'desc'(降序)
  • page — 页码(默认:1
  • perpage — 每页结果数(默认和最大:100
  • loop — 设为True获取所有页;或设为整数n获取前n页
  • query_type — 查询类别(默认:'stock'),可选值:
    • stock — A股股票
    • zhishu — 指数
    • fund — 基金
    • hkstock — 港股
    • usstock — 美股
    • threeboard — 新三板
    • conbond — 可转债
    • insurance — 保险
    • futures — 期货
    • lccp — 理财产品
  • retry — 失败重试次数(默认:10
  • sleep — 分页请求间延迟秒数(默认:0
  • log — 设为True在控制台打印日志
  • pro — 设为True使用付费版(需要对应的cookie)
  • no_detail — 设为True始终返回DataFrameNone(不返回dict)
  • find — 优先返回的股票代码列表,如 ['600519', '000010']
  • request_params — 传递给requests的额外参数,如 {'proxies': proxies}

返回值

  • 列表类查询 → 返回 pandas.DataFrame
  • 详情类查询 → 返回 dict(可能包含文本和DataFrame)

使用示例

查询市盈率低于20的股票

import pywencai

# 使用自然语言查询低市盈率股票
res = pywencai.get(query='市盈率小于20的股票', cookie='xxx')
print(res)

获取退市股票按日期排序

import pywencai

# 查询退市股票,按退市日期升序排列
res = pywencai.get(
    query='退市股票',
    sort_key='退市@退市日期',  # 指定排序字段
    sort_order='asc',          # 升序
    cookie='xxx'
)
print(res)

使用代理分页获取全部数据

import pywencai

# 配置HTTP代理
proxies = {'http': 'http://proxy:8080', 'https': 'http://proxy:8080'}

# loop=True自动分页获取所有数据;log=True打印请求日志
res = pywencai.get(
    query='昨日涨幅',
    sort_order='asc',          # 升序
    loop=True,                 # 自动获取所有页面
    log=True,                  # 打印日志信息
    cookie='xxx',
    request_params={'proxies': proxies}  # 传入代理配置
)
print(res)

查询指数数据

import pywencai

# 设置query_type='zhishu'查询指数数据
res = pywencai.get(
    query='上证指数近5日涨跌幅',
    query_type='zhishu',       # 设置查询类型为指数
    cookie='xxx'
)
print(res)

查询可转债数据

import pywencai

# 设置query_type='conbond'查询可转债数据
res = pywencai.get(
    query='可转债溢价率小于10%',
    query_type='conbond',      # 设置查询类型为可转债
    cookie='xxx'
)
print(res)

使用技巧

  • 适度使用 — 高频调用可能被问财服务器封禁。
  • 始终使用最新版本pip install pywencai --upgrade
  • 查询字符串使用中文自然语言 — 像在问财网站搜索一样编写查询。
  • loop=True且设置了find时,loop被忽略,仅返回前100条结果。
  • 使用付费数据时,设置pro=True并提供有效cookie

进阶示例

查询涨停股详情

import pywencai

Metadata

Author@coderwpf
Stars3409
Views0
Updated2026-03-25
View Author Profile
AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill
Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-coderwpf-pywencai": {
      "enabled": true,
      "auto_update": true
    }
  }
}
Safety NoteClawKit audits metadata but not runtime behavior. Use with caution.