mcpbeat Sign in

Jqdatasdk Agent Skill

by lzwme

聚宽（JoinQuant）本地数据 SDK，提供 A 股行情、历史K线、财务数据、指标数据等，与聚宽官网数据同源。当用户提及 jqdatasdk、聚宽数据、需要获取A股数据，或已注册聚宽账号时使用。与 baostock（免费）和 tushare（数据最全）不同，jqdatasdk 需注册聚宽账号获取 Token，适合已在使用聚宽平台的用户。本地数据获取请用本技能，聚宽官网策略开发请用 joinquant-docs 技能。

16k tokens
context cost
the whole folder, loaded on every use
8
files
ships runnable scripts
0
copies elsewhere
how many repositories repackaged it
169
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository 
npx skills add https://github.com/lzwme/finance-quant-skills --skill jqdatasdk

The instruction itself

1 sections, as written by the author

jqdatasdk 聚宽数据获取

任务目标

  • 本 Skill 用于:通过聚宽数据接口获取A股市场数据、财务指标和因子数据
  • 能力包含:实时行情、历史K线、财务数据、指标数据、股票信息、因子数据
  • 触发条件:用户提及聚宽、jqdata、jqdatasdk或需要获取A股数据、财务信息、因子数据时

前置准备

  • 依赖说明:安装 jqdatasdk 库（已包含在 dependency 中）
  • 凭证配置:需配置聚宽账号 Token（环境变量: JQDATA_TOKEN）或登录用户名及密码（环境变量: JQDATA_USERNAME、JQDATA_PASSWORD）
  • 账号申请:访问 https://www.joinquant.com/ 注册账号并获取 API Token（详见 references/jqdatasdk_quickstart.md）

操作步骤

  • 标准流程:
  • 确定数据需求 — 智能体理解用户意图（行情/K线/财务/因子等）
  • 调用对应脚本 — 根据数据类型选择脚本
  • 解析结果 — 智能体分析返回的 JSON 格式数据
  • 脚本调用映射:
  • 行情/K线/实时数据 → python scripts/market_data.py --type price --code 000001.XSHE --start 2024-01-01 --end 2024-01-31
  • 财务数据/指标/估值 → python scripts/financial_data.py --type fundamentals --code 000001.XSHE --statDate 2024
  • 股票列表/信息 → python scripts/stock_info.py --type all_securities --security_type stock
  • 因子数据 → python scripts/factor_data.py --code 000001.XSHE --factor valuation --start 2024-01-01 --end 2024-01-31
  • 可选分支:
  • 当需要多只股票数据:使用 --code 参数逗号分隔
  • 当需要指定频率:使用 --frequency 参数（1min/5min/15min/30min/60min/120min/daily/weekly/monthly）
  • 当需要调整价格类型:使用 --fq_ref_date 参数或直接指定复权类型

使用示例

  • 示例1:获取股票日K线数据
  • 场景/输入:用户说"查看平安银行最近一个月的K线数据"
  • 预期产出:返回日期、开盘价、最高价、最低价、收盘价、成交量等OHLCV数据
  • 关键要点:调用 python scripts/market_data.py --type price --code 000001.XSHE --start 2024-03-01 --end 2024-03-31 --frequency daily
  • 示例2:查询财务指标
  • 场景/输入:用户说"获取招商银行2023年的财务指标"
  • 预期产出:返回PE、PB、ROE、营业收入、净利润等财务指标
  • 关键要点:调用 python scripts/financial_data.py --type indicators --code 600036.XSHG --statDate 2023
  • 示例3:获取因子数据
  • 场景/输入:用户说"查询贵州茅台的估值因子"
  • 预期产出:返回市盈率、市净率、市值等估值因子数据
  • 关键要点:调用 python scripts/factor_data.py --code 600519.XSHG --factor valuation --start 2024-01-01 --end 2024-03-31

快速参考

常用代码示例

import jqdatasdk as jq
import pandas as pd

# 认证（需先设置环境变量 JQDATA_TOKEN 或 JQDATA_USERNAME/JQDATA_PASSWORD）
jq.auth(os.environ.get('JQDATA_USERNAME', ''), os.environ.get('JQDATA_PASSWORD', ''))
# 或使用 Token: jq.auth(token='your_token')

# 获取日K线数据
df = jq.get_price('000001.XSHE', start_date='2024-01-01', end_date='2024-12-31',
                  frequency='daily', fields=['open', 'high', 'low', 'close', 'volume'])

# 获取财务数据
q = jq.query(jq.valuation).filter(jq.valuation.code == '000001.XSHE')
fundamentals = jq.get_fundamentals(q, date='2024-01-01')

资源索引

  • 脚本:
  • scripts/market_data.py (用途与参数:获取行情/K线/实时数据，支持 --type/--code/--start/--end/--frequency/--count)
  • scripts/financial_data.py (用途与参数:获取财务/指标/估值数据，支持 --type/--code/--statDate/--columns)
  • scripts/stock_info.py (用途与参数:获取股票列表/信息，支持 --type/--security_type/--code)
  • scripts/factor_data.py (用途与参数:获取因子数据，支持 --code/--factor/--start/--end)
  • 参考:
  • references/jqdatasdk_quickstart.md (何时读取:首次配置或认证失败时)
  • references/api.md (何时读取：需要使用聚宽 Python API、查看详细API参数说明时)

注意事项

  • 脚本执行需配置聚宽账号 Token 或登录用户名及密码，首次使用需先完成凭证配置
  • 聚宽股票代码格式:上海市场为 XXXXXX.XSHG，深圳市场为 XXXXXX.XSHE
  • 部分数据（如财务数据）可能有延迟，建议在交易日9:30-15:00之外获取
  • 脚本返回 JSON 格式数据，智能体负责解析并转换为用户友好的展示
  • 调用频率有限制，避免短时间内大量请求（详见聚宽官方文档）
  • 首次使用建议先读取 jqdatasdk_quickstart.md 完成认证配置

Other skills for the same job

different authors, same section of the catalogue
Edgartools
by christophacham
×2

Python library for accessing, analyzing, and extracting data from SEC EDGAR filings. Use when working with SEC filings, financial statements (income statement, balance sheet, cash flow), XBRL financial data, insider trading (Form 4), institutional holdings (13F), company financials, annual/quarterly reports (10-K, 10-Q), proxy statements (DEF 14A), 8-K current events, company screening by ticker/CIK/industry, multi-period financial analysis, or any SEC regulatory filings.

15k tokens
Altllm Portal API Keys
by internet-court
×1

Use this skill when the user asks to list, create, inspect, update, disable, re-enable, or revoke AltLLM Portal API keys for external agents or applications. Do NOT use for wallet login, billing history, or payment links.

1k tokens
Altllm Portal Auth
by internet-court
×1

Use this skill when the user asks to log in or out with a wallet session, fetch a wallet sign-in challenge, verify an externally signed challenge, or troubleshoot AltLLM Portal wallet login for the local altllm CLI. Do NOT use for API key management, billing history, or payment links.

2k tokens
Altllm Portal CLI
by internet-court
×1

Use this umbrella skill when the request spans multiple AltLLM Portal CLI domains, or when you need to navigate the local altllm CLI in this repository across auth, API keys, billing history, NOWPayments payment links, and related x402 Portal top-up guidance.

2k tokens
Chaingpt
by internet-court
×1

Build with the ChainGPT Web3 AI developer platform. Full API/SDK reference and project scaffolding for: Web3 AI Chatbot & LLM, AI NFT Generator, Smart Contract Generator, Smart Contract Auditor, AI Crypto News, AgenticOS Twitter agents, and Solidity LLM. Use when building blockchain apps, Web3 chatbots, NFT tools, smart contract tools, crypto news feeds, AI agents, or integrating any ChainGPT API. Triggers: chaingpt, web3 ai, nft generator, smart contract audit, crypto news api, agenticos, solidity llm, cgpt, blockchain ai, token analytics.

4k tokens
Mppx
by internet-court
×1

TypeScript SDK for the Payment HTTP Authentication Scheme. Handles 402 Payment Required flows with Tempo, Stripe, and other payment methods. Use when integrating payments or mppx into a client or server application.

4k tokens
Near API Js
by internet-court
×1

>- Guide for developing with near-api-js v7 - the JavaScript/TypeScript library for NEAR blockchain interaction. (3) calling smart contracts, (4) managing accounts and keys, (5) working with NEAR RPC API, (6) handling FT/NFT tokens on NEAR, (7) using NEAR cryptographic operations (KeyPair, signing), (8) converting between NEAR units (yocto, gas), (9) gasless/meta transactions with relayers, (10) NEP-413 message signing for authentication, (11) storage deposit management for FT contracts. Triggers on any NEAR blockchain development tasks.

13k tokens
Near Kit
by internet-court
×1

TypeScript library for NEAR Protocol blockchain interaction. Use this skill when writing code that interacts with NEAR Protocol, including viewing contract data, calling contract methods, sending NEAR tokens, building transactions, creating type-safe contract wrappers, integrating wallets (Wallet Selector, HOT Connect), React hooks and providers (@near-kit/react), managing keys, testing with sandbox, meta-transactions (NEP-366), and message signing (NEP-413).

8k tokens

How to use it

Copy the folder

Take lzwme/jqdatasdk from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.