AgentSkillsCN

tencent-finance

通过腾讯财经 API 获取股票价格与行情，并支持股票对比。无需 API 密钥。支持美股、中国 A 股、港股。特别优化，适合在中国大陆地区使用。

SKILL.md
--- frontmatter
name: tencent-finance
description: Get stock prices, quotes, and compare stocks using Tencent Finance API. No API key required. Supports US stocks, China A-Shares, Hong Kong stocks. Optimized for use in mainland China.

Tencent Finance CLI

A Python CLI for fetching stock data from Tencent Finance API.

Features

  • •✅ No API key required - 无需申请 API Key
  • •✅ Works in mainland China - 针对中国大陆网络环境优化，直接访问腾讯财经 API
  • •✅ Fast & Stable - 比 Yahoo Finance API 更稳定，不受限流影响
  • •✅ Multi-market support - 支持美股、A股、港股

Installation

bash
chmod +x /path/to/skills/tencent-finance/tfin
ln -sf /path/to/skills/tencent-finance/tfin /usr/local/bin/tfin  # Optional: global access

Commands

Price (quick check)

bash
tfin AAPL              # Quick price
tfin price AAPL        # Same as above

Quote (detailed)

bash
tfin quote MSFT

Compare

bash
tfin compare AAPL,MSFT,GOOGL
tfin compare TSLA,NVDA

Search

bash
tfin search "tesla"
tfin search "bitcoin"

Help

bash
tfin help
tfin --help

Symbol Format

  • •US stocks: AAPL, MSFT, GOOGL, TSLA, NVDA
  • •China A-Shares: sh000001 (上证指数), sz399001 (深证成指), sh600519 (茅台)
  • •Hong Kong: hk00700 (腾讯), hk09988 (阿里), hk03690 (美团)
  • •Crypto: BTC-USD, ETH-USD

Examples

bash
# Quick price check
tfin AAPL
tfin TSLA

# Detailed quote
tfin quote NVDA

# Compare tech giants
tfin compare AAPL,MSFT,GOOGL,META,AMZN

# Search
tfin search "apple"
tfin search "bitcoin"

# China stocks
tfin sh000001           # 上证指数
tfin quote hk00700      # 腾讯控股

Data Source

This tool uses Tencent Finance API (腾讯财经 API).

Why Tencent API?

  • •在中国大陆网络环境下可直接访问，无需代理
  • •比 Yahoo Finance API 更稳定，不受限流影响
  • •数据覆盖美股、A股、港股等多个市场

Data includes:

  • •Current price (实时价格)
  • •Price change (absolute & percentage) (涨跌额/涨跌幅)
  • •Open, High, Low prices (开盘/最高/最低价)
  • •Previous close (昨收)
  • •Volume (成交量)
  • •Market cap (市值)
  • •P/E ratio (市盈率)
  • •P/B ratio (市净率)

Supported Markets

MarketExampleStatus
US StocksAAPL, TSLA, NVDA✅ Supported
China A-Sharessh000001, sz399001✅ Supported
Hong Konghk00700, hk09988✅ Supported
CryptoBTC-USD, ETH-USD✅ Supported
India NSE/BSERELIANCE.NS, TCS.BO❌ Not supported

Comparison with Yahoo Finance

FeatureYahoo Finance (yfinance)Tencent Finance (tfin)
Mainland China AccessOften blocked/restricted✅ Direct access
Rate LimitingFrequent✅ Stable
US Stocks✅ Supported✅ Supported
China A-SharesLimited✅ Full support
Hong Kong StocksSupported✅ Supported
Indian Stocks✅ Supported❌ Not supported
Options/DividendsSupported❌ Not supported

Requirements

  • •Python 3.7+
  • •requests
  • •rich
bash
pip3 install requests rich

Troubleshooting

"No data found"

  • •Verify the symbol format
  • •Try with prefix: usAAPL instead of AAPL
  • •Some international markets may not be supported

Connection errors

  • •Check internet connection
  • •Tencent API is optimized for mainland China and generally very stable

License

MIT License

Author

Created by Menrfa