stock-watchlist

What This Skill Does

The stock-watchlist skill is a powerful tool for investors and financial enthusiasts to manage their portfolios and monitor market movements directly from their chat interface. It enables real-time fetching of stock market data across A-share, Hong Kong, and US markets. Leveraging reliable interfaces, this skill provides comprehensive quote details, including current prices, percentage changes, daily ranges, market capitalization, and valuation ratios like PE (Price-to-Earnings) and PB (Price-to-Book). Beyond simple lookup, it facilitates the maintenance of a Markdown-based watchlist, allowing users to track their investments, calculate profits and losses based on cost price and volume, and sync metadata to ensure data accuracy.

Installation

To integrate this skill into your environment, use the following command in your terminal:

clawhub install openclaw/skills/skills/0xhyperdan/stock-watchlist

Ensure that you have Python installed, as the primary logic resides within the scripts/stock_watchlist.py file, which orchestrates the communication with financial data APIs.

Use Cases

1. Quick Market Check: Instantly retrieve up-to-the-minute stock prices for individual tickers or company names without visiting financial websites.
2. Portfolio Tracking: Organize long-term investments in a portable Markdown file that stays updated via the sync feature.
3. Portfolio Analytics: Automatically compute your total unrealized profit or loss based on your manual inputs of cost and quantity.
4. Market Research: Resolve ambiguous company names (like 'Ping An') to identify the correct instrument before requesting detailed statistics.

Example Prompts

1. "贵州茅台和腾讯现在的股价是多少？请提供关键基本面信息。"
2. "帮我把持仓的TSLA加到我的watchlist.md中，成本价是200，数量是10股。"
3. "查询我watchlist文件里的所有股票持仓盈亏情况。"

Tips & Limitations

• Ambiguity Management: When querying short or common names, the skill may return multiple candidates. Use the search command first to clarify the intended entity before requesting detailed quotes.
• Data Integrity: Avoid manually editing the lines between the <!-- stock-watchlist:start --> and <!-- stock-watchlist:end --> tags to prevent breaking the automated parsing logic.
• File Maintenance: Periodically run watchlist sync to ensure that the quote_id and symbol fields remain consistent with the latest market standards, which optimizes future performance. Keep the Markdown file organized, and do not remove the required table headers to ensure the script functions as expected.