Tecent Finance

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.

Security Scan

The SKILL.md describes a Python CLI (tfin) but the published skill bundle contains only documentation and no executable or install instructions — that mismatch (plus instructions to place a binary under /usr/local/bin) makes the package incoherent and potentially unsafe until the missing code/source is provided and inspected.

Purpose & Capability

The skill claims to provide a Python CLI named 'tfin' for Tencent Finance, but the bundle contains only SKILL.md and no code or install spec. The README assumes a tfin file exists at /path/to/skills/tencent-finance/tfin, which is not present in the published manifest — this is inconsistent and prevents verification of what the tool actually does.

Instruction Scope

Runtime instructions tell the user/agent to chmod a tfin binary and optionally symlink it into /usr/local/bin, then run that binary to fetch data from Tencent's API. Because the binary/source is missing, those instructions would either do nothing or depend on an external, unspecified binary. The instructions also direct network access (calling Tencent APIs) which is expected for the stated purpose but should be traceable to the included code; here it is not.

Install Mechanism

There is no install spec provided (lowest-risk in terms of automatic code execution). However, SKILL.md implies manual installation of a script that is not included and gives no authoritative download URL, release host, or repository to verify — that omission is a red flag because it forces users to obtain a binary from an unspecified source before use.

Credentials

The skill does not request environment variables, credentials, or config paths. The declared runtime requirements (Python 3.7+, requests, rich) are proportional to a CLI that queries a public finance API.

Persistence & Privilege

The skill does not request persistent privileges and always:false. However, the instructions recommend creating a symlink in /usr/local/bin (system-wide executable path), which requires elevated privileges and modifies system state — users should not place an unreviewed binary into that location.

What to consider before installing

Do not install or run an unreviewed 'tfin' binary. The skill package contains only documentation and no code or authoritative install source. Ask the publisher for the source repository or an official release URL and a copy of the tfin script so you (or someone you trust) can inspect it. If you must try it, run it inside an isolated environment (container or VM) and avoid creating system-wide symlinks in /usr/local/bin until you verify the code. Prefer packages distributed via a verifiable registry (PyPI, GitHub releases) with checksums/signatures. If the author cannot provide source or a trustworthy install method, treat the skill as untrusted.

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

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)

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

Quote (detailed)

tfin quote MSFT

Compare

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

Search

tfin search "tesla"
tfin search "bitcoin"

Help

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

# 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

Market	Example	Status
US Stocks	AAPL, TSLA, NVDA	✅ Supported
China A-Shares	sh000001, sz399001	✅ Supported
Hong Kong	hk00700, hk09988	✅ Supported
Crypto	BTC-USD, ETH-USD	✅ Supported
India NSE/BSE	RELIANCE.NS, TCS.BO	❌ Not supported

Comparison with Yahoo Finance

Feature	Yahoo Finance (yfinance)	Tencent Finance (tfin)
Mainland China Access	Often blocked/restricted	✅ Direct access
Rate Limiting	Frequent	✅ Stable
US Stocks	✅ Supported	✅ Supported
China A-Shares	Limited	✅ Full support
Hong Kong Stocks	Supported	✅ Supported
Indian Stocks	✅ Supported	❌ Not supported
Options/Dividends	Supported	❌ Not supported

Requirements

• Python 3.7+
• requests
• rich

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