← Back to Skills Marketplace
0xhyperdan

stock watch

by 🏝️Hyperdan · GitHub ↗ · v1.1.0 · MIT-0
cross-platform ✓ Security Clean
486
Downloads
0
Stars
2
Active Installs
4
Versions
Install in OpenClaw
/install stock-watchlist
Description
Query real-time stock prices, basic quote fields, and manage a Markdown watchlist for A-share, Hong Kong, and US stocks. Use when users ask in Chinese or by...
Usage Guidance
This skill appears coherent and limited in scope, but review these practical points before installing: - Network calls: the script queries third-party Eastmoney endpoints to resolve names and fetch quotes. Do not put secrets or sensitive content into queries or the watchlist file if you are concerned about outbound data. - Local file safety: by default the script only allows watchlist files inside the current working directory; you can expand allowed roots via STOCK_WATCHLIST_ALLOWED_ROOTS, but only add directories you trust. The code enforces Markdown extensions and marker comments. - Dependencies: ensure you run it in a Python environment with the 'requests' package installed. Review the included scripts if you need stronger guarantees (they are provided in the repo). - Hard-coded token: the code contains a hard-coded SEARCH_TOKEN constant for the Eastmoney search API; this is expected for the current implementation but is not a secret coming from you. - Autonomous invocation: the skill is user-invocable and not set to always:true. The platform may allow autonomous invocation by default; if you are worried about automatic runs, check platform controls for skill invocation. If you want higher assurance, inspect the full scripts (they are included) or run them in an isolated environment where network/file access can be monitored.
Capability Analysis
Type: OpenClaw Skill Name: stock-watchlist Version: 1.1.0 The stock-watchlist skill is a legitimate tool for querying real-time stock data from EastMoney APIs and managing a Markdown-based watchlist. The Python script (scripts/stock_watchlist.py) includes robust security practices, such as path validation to prevent directory traversal and restricting file operations to the current working directory or an environment-defined allowlist. No evidence of data exfiltration, malicious execution, or prompt injection was found.
Capability Assessment
Purpose & Capability
Name/description match the code and SKILL.md: the Python script queries Eastmoney search/quote endpoints and implements watchlist management in Markdown. There are no unexpected credentials, cloud APIs, or unrelated binaries requested.
Instruction Scope
SKILL.md instructs running the included scripts for search/quote/watchlist operations and explicitly limits watchlist files to Markdown in the workspace (or explicit safe roots). The instructions and tests align with the code. Note: the scripts perform outbound network requests to third-party Eastmoney endpoints (searchapi.eastmoney.com and push2.eastmoney.com), which is expected for fetching quotes.
Install Mechanism
No install spec is provided (instruction + code files only). The code depends on the Python 'requests' package but doesn't download or install external code during install; no remote archive downloads or untrusted installers are used.
Credentials
The skill does not require credentials or secrets. It reads one optional environment variable (STOCK_WATCHLIST_ALLOWED_ROOTS) to permit watchlist files outside the current working directory; this is proportionate to the documented behavior. No other env vars or sensitive config paths are accessed.
Persistence & Privilege
The skill is not set to always:true and does not request system-wide persistence or modify other skills' configs. It writes only to the specified watchlist Markdown file (and respects marker comments) and enforces path restrictions in code/tests.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install stock-watchlist
  3. After installation, invoke the skill by name or use /stock-watchlist
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.0
Version 1.0.3 - Updated documentation to clarify recommended usage of the --file parameter for watchlist operations. - Added a "安全边界" (security boundary) section, warning to only store watchlist files within the current working directory and providing best practices for file location. - Provided guidance on setting STOCK_WATCHLIST_ALLOWED_ROOTS for use outside the working directory. - Clarified recommended usage of watchlist init --force to prevent accidental overwriting of unrelated Markdown files. - No functional code changes; documentation only.
v1.0.2
- Added Python bytecode cache file: scripts/__pycache__/stock_watchlist.cpython-312.pyc - No changes to functionality, documentation, or user-facing features.
v1.0.1
No changes detected in this version.
v1.0.0
Initial release with comprehensive watchlist and real-time quote features: - Query real-time prices and key quote fields for A-share, Hong Kong, and US stocks by name or code, supporting both Chinese and ticker inputs. - Search stocks by Chinese name with support for ambiguity resolution. - Manage a personal watchlist in a Markdown file, including tracking cost price, quantity, and profit/loss calculations. - Automate adding, removing, syncing, and summarizing stocks in the watchlist via command-line interface. - Output tailored summaries of stock information and watchlist status for user queries.
Metadata
Slug stock-watchlist
Version 1.1.0
License MIT-0
All-time Installs 3
Active Installs 2
Total Versions 4
Frequently Asked Questions

What is stock watch?

Query real-time stock prices, basic quote fields, and manage a Markdown watchlist for A-share, Hong Kong, and US stocks. Use when users ask in Chinese or by... It is an AI Agent Skill for Claude Code / OpenClaw, with 486 downloads so far.

How do I install stock watch?

Run "/install stock-watchlist" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is stock watch free?

Yes, stock watch is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does stock watch support?

stock watch is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created stock watch?

It is built and maintained by 🏝️Hyperdan (@0xhyperdan); the current version is v1.1.0.

💬 Comments