← Back to Skills Marketplace
592
Downloads
1
Stars
1
Active Installs
4
Versions
Install in OpenClaw
/install pywencai
Description
同花顺问财自然语言数据查询工具 - 使用中文自然语言查询A股、指数、基金、港美股、可转债等市场数据。
Usage Guidance
This skill appears to do what it claims (query iwencai with a browser cookie), but there are several packaging inconsistencies you should resolve before use. Recommendations:
- Verify the upstream project (https://github.com/zsrl/pywencai) and confirm the package version you plan to pip install matches the skill bundle.
- Do not paste your iwencai cookie into public logs or share it; treat it as a secret. Prefer setting it as an environment variable (WENCAI_COOKIE) rather than embedding it in code, if the library supports that.
- Confirm whether node is actually needed in your environment (installing node enables the library's JS path) and run in an isolated environment (container/VM) if you must supply a real cookie.
- Ask the publisher to fix manifest inconsistencies (registry metadata vs metadata.json vs SKILL.md vs demo) and to update demo.py to explicitly show cookie usage so requirement expectations are clear.
- If in doubt, create a throwaway iwencai account/cookie when testing, and audit network traffic (e.g., via proxy) to confirm requests go only to iwencai endpoints before using any production credentials.
Capability Analysis
Type: OpenClaw Skill
Name: pywencai
Version: 1.0.3
The skill bundle provides an interface for the pywencai library to query financial data from the Tonghuashun Wencai platform using natural language. It requires a user-provided cookie for authentication, which is explicitly documented as necessary for the tool's functionality. The code and instructions in SKILL.md, demo.py, and metadata.json are consistent with the stated purpose and do not exhibit signs of malicious intent, prompt injection attacks, or unauthorized data exfiltration.
Capability Assessment
Purpose & Capability
The skill's name/description (natural-language queries against 同花顺问财/iwencai) align with the included docs and demo. Requiring python3 and node is plausible (the underlying pywencai library runs JS). Nothing else in the package claims unrelated capabilities.
Instruction Scope
SKILL.md clearly instructs the user to extract and supply an iwencai Cookie (sensitive secret) and shows how to pass it to pywencai.get. That is within the tool's stated purpose but is sensitive. There is an inconsistency: demo_project/demo.py calls pywencai.get without passing a cookie, contradicting SKILL.md which marks cookie as required. The instructions also suggest passing proxies and retry loops — normal, but potentially able to forward network traffic if misused.
Install Mechanism
This is an instruction-only skill with no install spec (lowest install risk). It references pip-installing the pywencai package (a normal public package). No downloaded URLs or archive extraction are present in the skill bundle.
Credentials
The skill requires an iwencai Cookie (sensitive session credential), which is logically necessary for the described functionality. However, the metadata is inconsistent about environment variables: the top-level registry metadata lists no required env vars, while metadata.json (openclaw.requires.env) lists WENCAI_COOKIE. This mismatch is a packaging/manifest coherence problem that could lead to accidental exposure or confusion about where to place credentials.
Persistence & Privilege
The skill does not request persistent or elevated platform privileges (always:false). It does not modify other skills or system-wide settings in the provided files.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install pywencai - After installation, invoke the skill by name or use
/pywencai - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.3
- 新增 demo_project/README.md 和 demo_project/demo.py,提供演示项目和示例代码。
- 方便用户快速上手和参考用法,无更改核心库,向后兼容。
v1.0.2
pywencai 1.2.0 introduces a major update to documentation, shifting to a fully Chinese README and including best practices and troubleshooting:
- 文档全面改为中文,并新增常见错误处理、Cookie管理建议及定时监控示例;
- 现包含Cookie获取方法、参数释义、丰富用法示例和自动化/进阶脚本样板;
- 进一步规范查询API参数说明和错误场景提醒,更便于中文用户理解与应用;
- 无代码或API变动。
v1.0.1
**Expanded examples and documentation for broader usage**
- Added `QUICK_REFERENCE.md`, `README.md`, `_meta.json`, `metadata.json`, and `requirements.txt` files for improved documentation and accessibility.
- SKILL.md now features numerous advanced usage examples covering technical indicators, capital flow, multi-criteria screening, fund/HK stock queries, and more.
- Improved clarity and detail in API parameter and return value explanations.
- Expanded practical tips for usage, cookie acquisition, and best practices.
- No changes to core logic or API; update is documentation and reference focused.
v1.0.0
init
Metadata
Frequently Asked Questions
What is pywencai?
同花顺问财自然语言数据查询工具 - 使用中文自然语言查询A股、指数、基金、港美股、可转债等市场数据。 It is an AI Agent Skill for Claude Code / OpenClaw, with 592 downloads so far.
How do I install pywencai?
Run "/install pywencai" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is pywencai free?
Yes, pywencai is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does pywencai support?
pywencai is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created pywencai?
It is built and maintained by coderwpf (@coderwpf); the current version is v1.0.3.
More Skills