看究竟API查询

提供A股股票及基金的实时与历史行情、财务数据、高管持股变动及机构动向等一站式金融数据查询接口。

Security Scan

The skill's stated purpose (financial data queries) aligns with the resources it asks for, but there are multiple inconsistencies and missing pieces — notably no packaged client code included while the docs instruct pip installing an external package and the metadata claims an API token requirement that the registry summary omits — so proceed cautiously.

Purpose & Capability

The skill claims to provide A-share and fund market and event data and documents many API endpoints; requesting a KJJ API token and a Python client is appropriate for that purpose. However there is an inconsistency between the top-level registry summary (which listed no required env vars) and metadata.json/openclaw.requires (which lists KJJ_API_TOKEN). Also the package name (equal-data / kjj client) is referenced but no client code is included in the skill bundle, so it relies on an external package being installed.

Instruction Scope

SKILL.md instructs developers/agents to pip install 'equal-data', read KJJ_API_TOKEN from environment (or call KjjApi.get_token()), and notes that it will create ~/.kjiujing/config.yaml to store the token locally. Those steps are within the stated purpose (auth and client setup) and the runtime actions (reading an env var, optionally creating a local config file) are expected. The doc does not instruct reading unrelated local data. The instructions do, however, permit the agent or user to run external package installation which expands the trust surface.

Install Mechanism

The skill is instruction-only and contains no install spec or client code; yet SKILL.md tells users/agents to run 'pip install equal-data'. That means the actual runtime client would come from PyPI (or another pip source) outside of the skill bundle. Because there is no pinned install spec, checksum, or included source, installing that package could pull arbitrary code. metadata.json also lists python and pandas dependencies, but the skill does not ship code — this mismatch increases risk and makes the install step non-auditable from the bundle alone.

Credentials

The only credential referenced in the docs and metadata is KJJ_API_TOKEN, which is reasonable and proportional for a third-party financial API. The SKILL.md explicitly describes storing the token locally in ~/.kjiujing/config.yaml. The only concern is the earlier-mentioned mismatch where the registry summary reported 'no required env vars' while metadata.json requires KJJ_API_TOKEN; that should be clarified before use.

Persistence & Privilege

The skill does not request always:true or other elevated platform privileges. It does write a local config file (~/.kjiujing/config.yaml) to store the API token, which is normal for CLI/API clients. There is no evidence the skill attempts to modify other skills or system-wide agent settings.

What to consider before installing

This skill appears to be a documentation wrapper for a third-party Python client (equal-data / kjj). Key points before installing or using it: 1) Verify the package 'equal-data' on PyPI (and its publisher) and prefer to inspect its source (GitHub repo referenced in metadata.json) before pip installing. 2) Confirm whether you need to set KJJ_API_TOKEN; metadata indicates this is required but the registry summary omitted it — clarify that expectation. 3) Installing the external pip package is the main risk: without code included in the bundle you cannot audit what the client will do (network calls, telemetry, additional dependencies). 4) The SKILL.md says token is stored locally (~/.kjiujing/config.yaml) and not uploaded — inspect the client code to verify that behavior. 5) If you decide to use it, run pip install and initial tests inside an isolated virtualenv or sandboxed environment and monitor network calls (confirm they go only to the documented domain, e.g., api.jiujing.com). 6) If you need higher assurance, ask the publisher for a signed release or include the client source in the skill bundle so it can be audited.

name	提供商	定位	数据覆盖
equal-data	看究竟	专业级金融数据服务解决方案	行情: A股/基金/指数实时与历史数据;<br>财务: 财报及三大报表;<br>基金画像: 经理履历/规模/业绩/风格

equal-data

概述

equal-data是一个财经数据接口包，主要是用于查询A股股票的每日成交价格。该模块通过标准化API方式统一了数据资产的对外服务方式，以帮助有需要的技术用户更实时、简洁、轻量的使用相关数据。

快速上手

• 安装python运行环境(推荐python3.7+)，并安装equal-data依赖包。

python -m venv test_env
source test_env/bin/activate
pip install equal-data

• 根据接口文档，使用python代码获取数据。（如高管增减持金额排行榜接口）

from kjj import KjjApi
import os

# 读取环境变量中的token, 或者读取本地记录的token
token = os.getenv('KJJ_API_TOKEN') or KjjApi.get_token()

api = KjjApi(token)

# 高管持股变动-增减持金额排行榜列表
data = api.query_kjj_data(
    interfaceId="14",
    period=None,  # Integer  # 默认: 1
    changeType=None,  # Integer  # 默认: 
    pageIndex=None,  # Integer  # 默认: 0
    pageSize=None,  # Integer  # 默认: 10
    selfSelected=None,  # boolean  # 默认: false
    sortDesc=None,  # String  # 默认: 1-DESC
)

参数格式说明

• 名称	类型	必填	默认值	说明
  interfaceId	String	是	14	接口ID
  period	Integer	否	1	1-近1月、2-近3月、3-近半年、4-近1年
  changeType	Integer	否	-	变动类型（增持：1，减持：-1）
  pageIndex	Integer	是	0	当前页从0开始
  pageSize	Integer	是	10	每页显示记录数
  selfSelected	boolean	否	false	true: 只看自选 false：全部（默认）
  sortDesc	String	否	1-DESC	排序描述 1-ASC/1-DESC 等，1表示增持金额 2增持数量 3占总股本比 4占流通股本比 <br>5净增持股数 6增持均价

• 返回格式：json

认证方式

本技能需要 看究竟 API Key，支持以下两种方式配置：

看究竟官网注册，获取token，

方式 B：配置环境变量。

export KJJ_API_TOKEN="your_key_here"

方式 B：配置文件 首次运行时会自动创建 ~/.kjiujing/config.yaml，提示用户填入 API Key。 密钥仅存储在用户本地，不会上传至任何服务器。

触发指令

• "看究竟API"
• “高管持股变动”
• “机构动向/机构跟踪/机构风云榜”
• “龙虎榜”
• “营业部交易数据”
• "看究竟的交易策略"

数据接口列表

接口ID	接口名称	分类	文档路径
1	究竟策略列表页	究竟策略	reference/小工具-究竟策略/究竟策略列表页.md
2	究竟策略首页	究竟策略	reference/小工具-究竟策略/究竟策略首页.md
3	究竟策略基本信息	究竟策略	reference/小工具-究竟策略/究竟策略基本信息.md
4	策略组合当前持仓日期列表	究竟策略	reference/小工具-究竟策略/策略组合当前持仓日期列表.md
5	策略组合调仓明细日期列表	究竟策略	reference/小工具-究竟策略/策略组合调仓明细日期列表.md
6	策略组合当前持仓	究竟策略	reference/小工具-究竟策略/策略组合当前持仓.md
7	策略组合持仓买卖明细	究竟策略	reference/小工具-究竟策略/策略组合持仓买卖明细.md
8	究竟策略最新交易明细	究竟策略	reference/小工具-究竟策略/究竟策略最新交易明细.md
9	策略组合走势图数据	究竟策略	reference/小工具-究竟策略/策略组合走势图数据.md
10	策略组合-调仓信号	究竟策略	reference/小工具-究竟策略/策略组合-调仓信号.md
11	策略组合-资产分布	究竟策略	reference/小工具-究竟策略/策略组合-资产分布.md
12	策略组合-指标列表	究竟策略	reference/小工具-究竟策略/策略组合-指标列表.md
13	策略组合-组合分析	究竟策略	reference/小工具-究竟策略/策略组合-组合分析.md
14	持股变动-增减持金额排行榜	高管持股	reference/小工具-高管持股/持股变动-增减持金额排行榜.md
15	持股变动列表	高管持股	reference/小工具-高管持股/持股变动列表.md
16	增减持计划列表	高管持股	reference/小工具-高管持股/增减持计划列表.md
17	个股详情/动态详情--增减持操作明细数据	高管持股	reference/小工具-高管持股/个股详情_动态详情--增减持操作明细数据.md
18	个股增减持计划详情	高管持股	reference/小工具-高管持股/个股增减持计划详情.md
19	搜索（支持股票代码、股票名称、高管搜索）	高管持股	reference/小工具-高管持股/搜索（支持股票代码、股票名称、高管搜索）.md
20	详情页基本信息（含数据分析）	高管持股	reference/小工具-高管持股/详情页基本信息（含数据分析）.md
21	搜索详情接口	高管持股	reference/小工具-高管持股/搜索详情接口.md
22	高管持股变动日期列表	高管持股	reference/小工具-高管持股/高管持股变动日期列表.md
23	机构动向列表2.5.0	机构动向	reference/小工具-机构动向/机构动向列表2.5.0.md
24	机构风云榜榜单2.5.0-基础信息	机构动向	reference/小工具-机构动向/机构风云榜榜单2.5.0-基础信息.md
25	机构风云榜-榜单详情数据2.5.0	机构动向	reference/小工具-机构动向/机构风云榜-榜单详情数据2.5.0.md
26	机构风云榜-榜单首页2.5.0	机构动向	reference/小工具-机构动向/机构风云榜-榜单首页2.5.0.md
27	机构风云榜-产品列表 2.5.0	机构动向	reference/小工具-机构动向/机构风云榜-产品列表_2.5.0.md
28	机构风云榜-季度筛选列表 2.5.0	机构动向	reference/小工具-机构动向/机构风云榜-季度筛选列表_2.5.0.md
29	首页机构动向	机构动向	reference/小工具-机构动向/首页机构动向.md
30	机构持仓日期列表	机构动向	reference/小工具-机构动向/机构持仓日期列表.md
31	机构历史个股追踪	机构动向	reference/小工具-机构动向/机构历史个股追踪.md
32	机构本期持股列表	机构动向	reference/小工具-机构动向/机构本期持股列表.md
33	机构持仓列表	机构动向	reference/小工具-机构动向/机构持仓列表.md
34	机构详情	机构动向	reference/小工具-机构动向/机构详情.md
35	机构搜索	机构动向	reference/小工具-机构动向/机构搜索.md
36	机构动向-往期市值规模	机构动向	reference/小工具-机构动向/机构动向-往期市值规模.md
37	机构动向-单个机构-往期市值规模	机构动向	reference/小工具-机构动向/机构动向-单个机构-往期市值规模.md
38	机构动向-下属分支机构列表(历史持股)	机构动向	reference/小工具-机构动向/机构动向-下属分支机构列表(历史持股).md
39	机构动向-下属分支机构列表/股东列表(本期)	机构动向	reference/小工具-机构动向/机构动向-下属分支机构列表_股东列表(本期).md
40	机构动向-下属分支机构列表（全部）	机构动向	reference/小工具-机构动向/机构动向-下属分支机构列表（全部）.md
41	首页-龙虎榜（前一个版本）	龙虎榜	reference/小工具-龙虎榜/首页-龙虎榜（前一个版本）.md
42	首页-龙虎榜(最新版本)	龙虎榜	reference/小工具-龙虎榜/首页-龙虎榜(最新版本).md
43	龙虎榜日期列表	龙虎榜	reference/小工具-龙虎榜/龙虎榜日期列表.md
44	游资榜列表	龙虎榜	reference/小工具-龙虎榜/游资榜列表.md
45	营业部所属游资席位	龙虎榜	reference/小工具-龙虎榜/营业部所属游资席位.md
46	营业部操作明细	龙虎榜	reference/小工具-龙虎榜/营业部操作明细.md
47	游资详情(返回游资信息以及营业部信息) 2.4.9	龙虎榜	reference/小工具-龙虎榜/游资详情(返回游资信息以及营业部信息)_2.4.9.md
48	搜索	龙虎榜	reference/小工具-龙虎榜/搜索.md
49	龙虎榜胜率排行榜2.4.9	龙虎榜	reference/小工具-龙虎榜/龙虎榜胜率排行榜2.4.9.md
50	龙虎榜单-个股榜2.4.9	龙虎榜	reference/小工具-龙虎榜/龙虎榜单-个股榜2.4.9.md
51	龙虎榜单-游资榜2.4.9	龙虎榜	reference/小工具-龙虎榜/龙虎榜单-游资榜2.4.9.md
52	龙虎榜单-营业部榜2.4.9	龙虎榜	reference/小工具-龙虎榜/龙虎榜单-营业部榜2.4.9.md
53	龙虎榜游资详情页-交易分析2.4.9	龙虎榜	reference/小工具-龙虎榜/龙虎榜游资详情页-交易分析2.4.9.md
54	龙虎榜日期列表（近1年/近1月）2.4.9	龙虎榜	reference/小工具-龙虎榜/龙虎榜日期列表（近1年_近1月）2.4.9.md
55	游资近期操作2.4.9	龙虎榜	reference/小工具-龙虎榜/游资近期操作2.4.9.md
56	游资近1月操作日期列表2.4.9	龙虎榜	reference/小工具-龙虎榜/游资近1月操作日期列表2.4.9.md
57	市场高度	龙虎榜	reference/小工具-龙虎榜/市场高度.md

数据来源与依赖

• API 提供商: 看究竟(kjiujing.com)
• 官方文档: https://api.kjiujing.com/docs
• 数据用途: 仅用于获取行情数据，不涉及交易操作
• 开源依赖:
  • requests (Apache 2.0)
  • pandas (BSD 3-Clause)
  • equal-data