Skill: terrycarter1985/douyin-search (version 3.0.0)

--- name: douyin-scraper description: > Search Douyin (抖音) by natural language query. Extracts search suggestions, trending topics, and video results via Douyin's web API. Supports keyword search, trending discovery, and search suggestions without captcha. version: 2.1.0 --- # Douyin Scraper > Search Douyin like a human: just say what you want to find. ## What This Skill Does - **Natural language search** — parse "搜索一下海鲜视频" into a keyword search - **Search suggestions** — get related keywords and phrases (no captcha needed) - **Hot/trending topics** — browse current Douyin trending searches (no captcha needed) - **Full video search** — attempt full search results (may require captcha) ## What This Skill Does NOT Do - Download video files (use `douyin-downloader` skill) - Post or publish content - Analyze script quality (use the `douyin` skill) - Bypass captcha/anti-bot protections ## Prerequisites - Python 3.8+ - `agent-browser` CLI (optional, for browser-based search) ## Quick Start ### Search by natural language (auto mode) ```bash python3 scripts/search.py "海鲜视频" ``` This runs all three strategies in sequence: 1. Search suggestions (related keywords) 2. Hot/trending topics (filtered by keyword) 3. Full search (may fail due to captcha) ### Search suggestions only ```bash python3 scripts/search.py "海鲜视频" --suggestions ``` ### Hot/trending topics ```bash python3 scripts/search.py "海鲜视频" --hot ``` ### Full video search ```bash python3 scripts/search.py "海鲜视频" --full ``` Note: Full search requires X-Bogus signature and may be blocked by captcha. ## Execution Protocol (for AI agents) ### Step 1: Parse the search intent Extract the core search query from natural language: - "搜索一下海鲜视频" → keyword: `海鲜视频` - "帮我找做菜的视频" → keyword: `做菜` - "抖音上最近火的" → use `--hot` mode - "海鲜相关有什么推荐" → use `--suggestions` mode ### Step 2: Run the search script ```bash python3 scripts/search.py "{keyword}" ``` ### Step 3: Return results The script outputs structured results. Present them to the user in a clean format. ### Step 4: Follow-up If the user wants to see specific videos, try: - Browser-based search: `agent-browser open "https://www.douyin.com/search/{keyword}"` (may encounter captcha, which requires manual solving) - Search by video ID: `https://www.douyin.com/video/{vid}` ## API Endpoints Used | Endpoint | Captcha | Returns | |---|---|---| | `/aweme/v1/web/search/sug/` | No | Search suggestions | | `/aweme/v1/web/hot/search/list/` | No | Trending topics | | `/aweme/v1/web/search/item/` | Yes | Full video results | ## Limitations - **Full search requires captcha**: Douyin's search API blocks automated requests with a slider captcha. The suggestions and hot search APIs work without captcha. - **No video download**: This skill only searches and lists results. - **Rate limiting**: Don't make too many requests in a short time. ## Activation Rules (for AI agents) ### Use this skill when the user asks to: - Search Douyin for videos by keyword - Find content on 抖音 - Look up trending Douyin videos - "搜索一下..." on Douyin - Get search suggestions for a Douyin topic ### Do NOT use this skill when: - The user wants script analysis (→ `douyin` skill) - The user wants to download videos (→ `douyin-downloader` skill) - The user wants to post content (→ `douyin-publish` skill)


Security scan verdicts — ClawScan: malicious | static analysis: clean | VirusTotal:  | SkillSpector:  ()