tencent-finance

What This Skill Does

The Tencent Finance (tfin) skill is an OpenClaw agent tool designed to provide real-time stock market data by interfacing with the Tencent Finance API. It is specifically engineered to perform reliably within mainland China, where many international financial data providers face connectivity issues or aggressive rate-limiting. This tool allows the agent to fetch current prices, detailed market quotes, compare multiple financial assets side-by-side, and search for stock tickers using natural language queries. It supports a diverse range of markets, including US exchanges, China A-Shares, Hong Kong stocks, and major cryptocurrencies.

Installation

To integrate this skill into your environment, use the OpenClaw command-line interface provided in your terminal:

clawhub install openclaw/skills/skills/pz325/tecent-finance

Ensure that your environment has Python 3.7+ installed, along with the requests and rich dependencies. For persistent shell access, consider symlinking the execution script to a directory in your PATH (e.g., /usr/local/bin/tfin).

Use Cases

• Market Monitoring: Use the tool to quickly check the pulse of global markets by fetching current prices for portfolios.
• Trend Comparison: Use the compare functionality to visualize the performance gap between major tech stocks or index constituents.
• Investment Research: Extract detailed quote information—such as P/E ratios, market capitalization, and previous close data—to support fundamental analysis.
• Localized Reporting: Ideal for users or automated agents operating within mainland China who require stable, high-availability financial data without the need for proxy services.

Example Prompts

1. "Check the current stock price for Tesla (TSLA) and compare it against Nvidia (NVDA)."
2. "Search for the stock ticker for Alibaba and provide a detailed quote including market cap and P/E ratio."
3. "Get the latest market data for the Shanghai Composite index (sh000001)."

Tips & Limitations

This tool is optimized for stability, but it is important to note that it does not provide historical trend charting or derivative data like options and dividends. Ensure that your stock tickers follow the specific formatting: use prefixes for A-shares (e.g., sh for Shanghai, sz for Shenzhen) and Hong Kong stocks (e.g., hk). If you receive a 'No data found' error, double-check your ticker symbol syntax against the official documentation.