tencenthotsearch-skill（腾讯热搜技巧）

⚠️ BEFORE INSTALLING - Security Notice This skill requires Tencent Cloud API credentials (SecretId/SecretKey). Please read Security Considerations before providing credentials. Verify Source: Check the GitHub repository for code audit. Use Temporary Keys: Only use temporary/least-privileged API keys for testing. Run in Isolation: Execute in container/VM with non-sensitive output directory.

TencentHotSearch Skill

Overview

TencentHotSearch-skill is a trending news and article search tool based on Tencent Cloud Online Search API (SearchPro). It supports web-wide search or site-specific search to retrieve popular articles and news related to keywords.

API Information:

• Endpoint Domain: wsa.tencentcloudapi.com
• API Version: 2025-05-08
• API Name: SearchPro

Features

• Multi-keyword Search: Supports 1-5 keywords for combined search
• Site-specific Search: Choose between web-wide search or specific sites (e.g., qq.com, news.qq.com)
• Multiple Search Modes:

- Natural search results (Mode=0, default) - Multimodal VR results (Mode=1) - Mixed results (Mode=2)

• Time Filtering: Filter results by start time and end time
• Industry Filtering: Filter by industry (gov/news/acad/finance, Premium version)
• Structured Results: Returns complete information including title, summary, dynamic summary, source platform, publish time, original link, relevance score, image list, etc.
• Multi-format Output: Supports JSON, CSV, TXT, MD format output (default: MD)
• Custom Output Path: Supports setting default output directory in configuration file
• Compliance & Security: All data is obtained through Tencent's official API compliantly

Security Considerations

Before installing and using this skill, please carefully read the following security guidelines:

⚠️ Important Notice

Registry Metadata Inconsistency: The registry metadata claims 'no credentials/config required', but both SKILL.md and the code require a config.json file containing your Tencent SecretId and SecretKey. This is a documentation mismatch that users should be aware of.

Pre-Installation Checklist

1. Verify Source and Provenance

- Review the skill source code yourself - Check the publisher's credibility - Note: Source/homepage links may be missing - verify from trusted sources

1. Inspect the Code

- Review scripts/tencent_hotsearch.py to understand the signing and HTTPS calls - The code performs legitimate Tencent Cloud API calls - No hidden exfiltration mechanisms detected, but always review yourself

1. Use Minimal/Temporary Credentials

- Use temporary or least-privileged API keys - Create dedicated API keys for this skill - Safely rotate/delete keys after testing - Follow the principle of least privilege

1. Run in Isolated Environment

- Use container/VM for execution - Do not point output_dir to sensitive system paths - Use dedicated temporary directory or sandbox environment

1. Protect Configuration Files

- Do NOT commit config.json to version control - Follow the provided .gitignore configuration (already set up) - Set file permissions: chmod 600 config.json (Linux/macOS) - Regularly rotate API keys

For Higher Confidence

If you need higher assurance before installation:

• Ask the publisher to correct registry metadata to explicitly declare required credentials
• Request a verified homepage or repository URL
• Ask for signed releases or upstream repository URL for auditing
• Review the full source code in scripts/tencent_hotsearch.py

Security Features Implemented

✅ Path Traversal Prevention: Validates output paths to prevent directory traversal attacks ✅ Secret Masking: Masks API keys in error messages and logs ✅ HTTPS Only: All API requests use encrypted HTTPS connections ✅ Official Endpoint: Only accesses official Tencent Cloud API (wsa.tencentcloudapi.com) ✅ Git Protection: .gitignore configured to exclude config.json ✅ Error Handling: Comprehensive error handling with secure credential management

For detailed security recommendations, see CONFIG.md

When to Use

Invoke this skill when users have the following needs:

• Want to get trending news or trending topics in a specific field
• Need to search for the latest articles related to specific keywords
• Want to track hot events or plan content topics
• Need to quickly grasp dynamics in a specific field
• Need to search content within specific sites (e.g., Tencent.com, news channels)
• Need to filter search results by time range or industry

Usage

Quick Start (Command Line)

1. Install Dependencies

pip install -r requirements.txt

2. Configure Tencent Cloud API

Edit the config.json file and fill in your Tencent Cloud API credentials:

{
  "secret_id": "YOUR_TENCENT_CLOUD_SECRET_ID",
  "secret_key": "YOUR_TENCENT_CLOUD_SECRET_KEY",
  "output_dir": "./output"
}

For detailed configuration instructions, refer to CONFIG.md

3. Run Search

# Web-wide search (default mode, MD format output)
python scripts/tencent_hotsearch.py "AI" "machine learning" -l 10

# Site-specific search (Tencent.com)
python scripts/tencent_hotsearch.py "AI" "machine learning" -s qq.com -l 10

# Site-specific search (News channel)
python scripts/tencent_hotsearch.py "technology" "innovation" -s news.qq.com -l 15

# Multimodal VR mode search
python scripts/tencent_hotsearch.py "AI" -m 1 -l 10

# Mixed mode search
python scripts/tencent_hotsearch.py "AI" -m 2 -l 20

# Search by time range
python scripts/tencent_hotsearch.py "AI" --from-time 1704067200 --to-time 1706745600

# Filter by industry (Premium)
python scripts/tencent_hotsearch.py "AI" --industry news -l 20

# Save results to specified file
python scripts/tencent_hotsearch.py "AI" "machine learning" -o results.md

# Save results to JSON file
python scripts/tencent_hotsearch.py "AI" "machine learning" -o results.json -f json

# Save results to CSV file
python scripts/tencent_hotsearch.py "AI" "machine learning" -o results.csv -f csv

# Save results to TXT file
python scripts/tencent_hotsearch.py "AI" "machine learning" -o results.txt -f txt

# Print results to console
python scripts/tencent_hotsearch.py "AI" "machine learning" --print

# Custom storage path (relative path)
python scripts/tencent_hotsearch.py "AI" -o output/ai_results.txt -f txt

# Custom storage path (absolute path)
python scripts/tencent_hotsearch.py "technology" -o /path/to/your/output/tech_news.md -f md

Parameters

Command Line Arguments

Example

{
  "keywords": ["artificial intelligence", "machine learning"],
  "site": "qq.com",
  "mode": 0,
  "limit": 10,
  "from_time": 1704067200,
  "to_time": 1706745600,
  "industry": "news"
}

Response Format

{
  "results": [
    {
      "title": "Article Title",
      "summary": "Standard summary...",
      "dynamic_summary": "Dynamic summary (Premium version)...",
      "source": "Source Platform",
      "publishTime": "2024-01-15 10:30:00",
      "url": "https://example.com/article",
      "score": 0.8978,
      "images": ["https://example.com/image1.jpg"],
      "favicon": "https://example.com/favicon.ico"
    }
  ],
  "total": 10,
  "query": {
    "keywords": ["artificial intelligence", "machine learning"],
    "site": "qq.com",
    "mode": 0
  }
}

API Configuration

Tencent Cloud Online Search API

Setup Steps

1. Visit Tencent Cloud Console
2. Log in to your Tencent Cloud account
3. Navigate to "Products" -> "Artificial Intelligence" -> "Online Search"
4. Activate the service and obtain API credentials (SecretId and SecretKey)
5. Select appropriate region (e.g., ap-guangzhou)

Configuration Parameters

Output Formats

1. Markdown Format (Default)

Suitable for viewing in Markdown editors, includes formatted titles, links, and metadata.

# Search Results

**Total results:** 10
**Timestamp:** 2024-01-15T10:30:00

---

## 1. Article Title

**Summary:** Content summary...

**Dynamic Summary:** Dynamic summary content...

**Source:** Source Platform

**Time:** 2024-01-15 10:30:00

**Link:** [https://example.com/article](https://example.com/article)

**Relevance:** 0.8978

---

2. JSON Format

Structured data, suitable for program processing and data analysis.

{
  "results": [...],
  "total": 10,
  "timestamp": "2024-01-15T10:30:00"
}

3. CSV Format

Table format, suitable for opening in Excel and other tools for data analysis.

4. TXT Format

Plain text format, suitable for quick reading and copy-paste.

Search Modes

Mode 0: Natural Search Results (Default)

• Returns traditional web search results
• Supports filtering parameters such as Site, FromTime, ToTime, Industry
• Suitable for regular search needs

Mode 1: Multimodal VR Results

• Returns multimodal VR search results
• Note: Site, FromTime, ToTime, Industry parameters are invalid in this mode
• Suitable for scenarios requiring rich media content

Mode 2: Mixed Results

• Returns a mix of multimodal VR results and natural search results
• Site, FromTime, ToTime, Industry parameters only apply to natural results
• Suitable for scenarios requiring comprehensive search results

Industry Filters (Premium Version)

Dependencies

• Python 3.7+
• No external dependencies (core functionality uses only Python standard library)
• Optional: pandas>=2.0.0 (only when CSV export functionality is needed)

Security Considerations

API Credentials Protection

• ⚠️ DO NOT commit config.json to version control (Git)
• ⚠️ Use .gitignore to ignore config.json (already configured)
• ⚠️ Rotate API keys regularly
• ⚠️ Use different keys for different environments
• ⚠️ Follow least privilege principle when configuring API keys

Output Directory Safety

• ⚠️ Do not set output directory to sensitive system paths
• ⚠️ Recommended to use dedicated temporary directory or sandbox environment
• ⚠️ Program will automatically create output directory but prevents directory traversal attacks

Runtime Environment

• ⚠️ Recommended to run in isolated environment (container or sandbox)
• ⚠️ Use temporary API keys with minimal permissions for testing
• ⚠️ Rotate/delete keys after testing

Network Security

• ✅ All API requests are encrypted via HTTPS
• ✅ Only accesses official Tencent Cloud API endpoint (wsa.tencentcloudapi.com)
• ✅ Request timeout set to 30 seconds to avoid long blocking

Installation

# Clone repository
git clone https://github.com/neuhanli/skills.git
cd skills/TencentHotSearch-skill

# Install dependencies
pip install -r requirements.txt

# Configure API credentials
cp config.example.json config.json
# Edit config.json and fill in your API credentials

Error Handling

• Configuration file not found: Prompt to create config.json file
• API authentication failed: Check if SecretId and SecretKey are correct
• Network error: Check network connection and API service status
• Parameter error: Check keyword count, timestamp format, etc.

Notes

• Keyword limit: 1-5 keywords
• Result limit: 10/20/30/40/50 (Premium version supports up to 50)
• Timestamp format: Unix timestamp (seconds)
• Industry filtering only supported in Premium version
• Dynamic summary only supported in Premium version

License

MIT License

Author

Created for Agent Skills platform