free-stock-global-quotes-news

What This Skill Does

The free-stock-global-quotes-news skill is a versatile financial data tool designed for the OpenClaw AI agent. It allows users to retrieve real-time stock quotes, historical market data, and company news for a wide range of global markets, including US exchanges, Hong Kong (HK), and China A-shares (SS/SZ). By aggregating data from reliable sources such as Yahoo Finance, Tencent, EastMoney, and AkShare, this skill eliminates the need for expensive proprietary financial APIs for basic market tracking. The skill intelligently selects the optimal data provider based on the market type, ensuring seamless integration for global portfolios.

Installation

To integrate this skill into your environment, use the command: clawhub install openclaw/skills/skills/antaeus001/free-stock-global-quotes-news. Ensure that your environment has Python 3 installed. While this skill is designed to function without API keys for most local and Asian market queries, users requiring advanced US market news should obtain a free API key from Finnhub.io and set the FINNHUB_API_KEY environment variable in your OpenClaw configuration file (typically located at ~/.openclaw/.env).

Use Cases

• Tracking daily price performance for US, HK, and Chinese stocks.
• Analyzing historical stock trends using specific time ranges (e.g., 5d, 1mo, 1y).
• Fetching the latest corporate news updates for individual tickers to inform investment decisions.
• Automating financial reports through structured JSON outputs.
• Providing quick market context for users asking about specific company tickers like AAPL, 0700.HK, or 600519.SS.

Example Prompts

1. "What is the current stock price for Apple (AAPL) and has it changed much today?"
2. "Show me the latest news and current price for Tencent (0700.HK)."
3. "Can you get me the 1-month historical price trend for Kweichow Moutai (600519.SS)?"

Tips & Limitations

• Symbol Accuracy: Always follow the designated format: US (Ticker), HK (Code.HK), and Shanghai/Shenzhen (Code.SS / Code.SZ). Incorrect formatting may lead to retrieval errors.
• Network Restrictions: If you are hosting the agent on a cloud server, be aware that Yahoo Finance often blocks datacenter IPs. The script automatically handles HTTPS_PROXY and HTTP_PROXY environment variables to bypass these restrictions. If errors persist, ensure a Finnhub API key is configured as a secondary fallback.
• Data Variability: While Chinese and HK data sources are highly reliable through the Tencent/EastMoney integration, news for specific small-cap stocks might vary based on the availability of public records via AkShare.
• JSON Output: For programmatic usage by other agent skills, append the --json flag to return raw, machine-readable data instead of a conversational summary.