Agent skill

Douyin Video Search

by browser-act in browser-act/skills

Searches Douyin (douyin.com) for videos by keyword and returns structured video data including author info, stats, cover, description, hashtags, and download URL.

MITAuto-check passedData & Analytics

Install Douyin Video Search

skills CLI
$ npx skills add browser-act/skills --skill douyin-video-search -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install browser-act/skills douyin-video-search --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/browser-act/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/solutions/video-platforms/douyin-video-search .claude/skills/douyin-video-search && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
douyin-video-search
GitHub stars
6.1k
Token cost
~1.8k tokens
SKILL.md length
757 words
Files
2 (incl. scripts)
Skills in repo
87
Repo updated
First seen
Licence
MIT

At a glance

Searches Douyin (douyin.com) for videos by keyword and returns structured video data including author info, stats, cover, description, hashtags, and download URL.

  • Works in 2 steps: Tool Readiness → Login Verification
  • User mentions Douyin search
  • SKILL.md covers Language, Objective, Prerequisites and Pre-execution Checks, plus 7 more sections
  • Runs Python scripts from its folder; calls python; reaches douyin.com and p3-pc-sign.douyinpic.com

What it does

Douyin Video Search is an agent skill from browser-act/skills. Searches Douyin (douyin.com) for videos by keyword and returns structured video data including author info, stats, cover, description, hashtags, and download URL. Supports date range filtering and sorting by relevance, likes, or recency. Use when user mentions Douyin search, scrape Douyin videos, collect TikTok China videos, extract douyin video data, grab douyin results, fetch douyin keyword videos, douyin video list, douyin content mining, search douyin by keyword, douyin likes filter, douyin date filter…

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/search-videos.py`).

It sits in Data & Analytics, covering Web scraping. It works with Douyin and TikTok. The repository describes itself as: Browser automation CLI built for AI agents. Break through anti-bot walls, hand off to humans across platforms when stuck. Parallel multi-task execution, independent multi-session… The licence is MIT.

When your agent uses it

  • User mentions Douyin search
  • Scrape Douyin videos
  • Collect TikTok China videos
  • Extract douyin video data

Example prompts

  • “Use the douyin-video-search skill to search Douyin (douyin.com) for videos by keyword and returns structured video data including author info…”
  • “/douyin-video-search”

Requirements

  • Python 3

Workflow steps

2 steps, taken from the step headings in SKILL.md.

  1. Tool Readiness
  2. Login Verification

What it can do on your machine

Read from SKILL.md and the folder at commit 11c057b. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • douyin.com
    • p3-pc-sign.douyinpic.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Douyin Video Search loads about 1.8k tokens when it runs. Until then it costs about 169 tokens; SKILL.md has 757 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~169
When it runs · the whole SKILL.md, loaded when a task matches
~1.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from browser-act/skills at commit 11c057b, republished under its MIT licence (© browser-act). 757 words, ~1,842 tokens.

Download SKILL.mdSave it as .claude/skills/douyin-video-search/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
douyin-video-search
description
Searches Douyin (douyin.com) for videos by keyword and returns structured video data including author info, stats, cover, description, hashtags, and download URL. Supports date range filtering and sorting by relevance, likes, or recency. Use when user mentions Douyin search, scrape Douyin videos, collect TikTok China videos, extract douyin video data, grab douyin results, fetch douyin keyword videos, douyin video list, douyin content mining, search douyin by keyword, douyin likes filter, douyin date filter, douyin video download links, douyin creator info, douyin hashtag extraction, douyin video scraper, douyin KOL research, douyin content analysis.

Keyword → paginated list of videos with author, stats, cover, description, hashtags, download URL

Language

All process output to user (progress updates, process notifications) follows the user's language.

Objective

Fetch Douyin video search results for a given keyword, with optional sort order and date filters, returning complete structured data for each video.

Prerequisites

  • Browser is open and navigated to any Douyin page (douyin.com) with an active logged-in session
  • User is logged in to Douyin (avatar visible in top-right corner)

Pre-execution Checks

1. Tool Readiness

If browser-act has been confirmed available in the current session → skip this step.

Invoke browser-act via Skill tool to load usage. If installation or configuration issues arise, follow its guidance to resolve then retry.

2. Login Verification

If login status for Douyin has been confirmed in the current session → skip this step.

Otherwise: navigate to https://www.douyin.com and check the top-right corner:

  • User avatar or account name visible → logged in, continue
  • "登录" button visible → not logged in; inform the user and assist them in completing login via remote-assist

User refuses or cannot log in → terminate execution.

Capability Components

This Skill's operational boundary = what the user can manually do in their browser. It only reads data already visible to the logged-in user, never bypassing authentication or access controls. JS code is in scripts/ and invoked via eval "$(python scripts/xxx.py {params})". Use the bash tool for execution.

API: Search videos by keyword

Navigate to the Douyin search page first to establish cookie context, then call the search API directly.

Step 1 — Navigate to search page:

navigate https://www.douyin.com/search/{keyword}?type=video
wait stable

Replace {keyword} with the URL-encoded search term (e.g., AI%E5%88%9B%E4%B8%9A).

Step 2 — Fetch search results:

bash
eval "$(python scripts/search-videos.py '{keyword}' --offset {offset} --count 20 --sort-type {sort_type} --publish-time {publish_time} --search-id '{search_id}')"

Parameters:

  • keyword: search term (plain text, script handles URL encoding)
  • --offset: pagination offset; start at 0, then use next_offset from previous response (default: 0)
  • --count: results per page (default: 20, max: 20)
  • --sort-type: sort order — 0=综合排序/comprehensive (default), 1=最多点赞/most liked, 2=最新发布/latest
  • --publish-time: date filter in days — 0=不限/all time (default), 1=一天内/1 day, 7=一周内/7 days, 180=六个月内/6 months, 365=一年内/1 year
  • --search-id: leave empty for first page; use next_search_id from previous response for page 2+

Output example:

json
{
  "items": [
    {
      "aweme_id": "7656392146064639419",
      "title": "深度还原7姐妹创业 #ai #搞笑视频 #热门",
      "author_name": "楠楠AI小剧场",
      "author_profile_url": "https://www.douyin.com/user/MS4wLjABAAAAY4eph...",
      "video_url": "https://www.douyin.com/video/7656392146064639419",
      "cover_url": "https://p3-pc-sign.douyinpic.com/image-cut-tos-priv/...",
      "description": "深度还原7姐妹创业 #ai #搞笑视频 #热门 #逆天 #宝妈创业",
      "hashtags": ["#ai", "#搞笑视频", "#热门", "#逆天", "#宝妈创业"],
      "download_url": "https://www.douyin.com/aweme/v1/play/?video_id=v2700f...",
      "digg_count": 188184,
      "comment_count": 3346,
      "publish_time": 1782642711
    }
  ],
  "count": 20,
  "has_more": 1,
  "next_offset": 20,
  "next_search_id": "20260709115250C6DC5EE42A6DC2D6B48D"
}

Error handling:

  • status_code: 2483 → session cookie is invalid or expired; re-verify login and retry navigation step before calling again
  • error: true in output → check message field; most common cause is session expiry, retry after navigating to https://www.douyin.com once
  • If count in response is 0 with has_more: 0 → no more results, pagination complete

Enum Parameters

[AI] sort_type — UI filter panel options (read from 筛选 dropdown):

  • 0: 综合排序 (comprehensive, default)
  • 1: 最多点赞 (most liked)
  • 2: 最新发布 (latest/newest)

[AI] publish_time — UI filter panel options (read from 筛选 dropdown):

  • 0: 不限 (all time, default)
  • 1: 一天内 (within 1 day)
  • 7: 一周内 (within 7 days)
  • 180: 六个月内 (within 6 months)
  • 365: 一年内 (within 1 year)
Show full SKILL.md (303 more words)Show less

Pagination

API Pagination: parameter offset, type: page-number-style increment. Start value: 0. Next page: use next_offset from response. Also pass next_search_id from first response as --search-id for all subsequent pages. Termination: has_more == 0 or count == 0 in response.

Success Criteria

count >= 1 AND items[0].aweme_id is non-null AND items[0].digg_count is non-null

Known Limitations

  • Requires an active Douyin login session; API returns status_code: 2483 when unauthenticated or session expires
  • download_url is a redirect URL (/aweme/v1/play/); the actual MP4 is at the final CDN redirect destination. Follow the redirect to obtain the direct file URL
  • Filter parameter values for sort_type and publish_time are based on observed API behavior; edge-case values beyond the listed options are untested
  • Douyin may impose rate limits on repeated search requests from the same session; add a 1–2 second delay between paginated requests in batch scripts

Execution Efficiency

  • Batch orchestration: Write a bash loop to iterate through pages serially within a single session; add 1–2 second sleep between requests to avoid rate-limit triggers
  • Test before batch: Run with --count 5 for 1–2 pages first to confirm the script works before executing the full batch
  • Error resumption: Save next_offset and next_search_id after each page so batch can resume from the last successful page on failure
  • Multiple keywords: For multiple keywords, loop through them sequentially in one session; re-navigate to each keyword's search URL before calling the API

Experience Notes

Path: {working-directory}/browser-act-skill-forge-memories/douyin-video-search-douyin-video-search.memory.md

Before execution: If the file exists, read it first — it records unexpected situations from past runs (e.g., API parameter changes, session handling quirks); adjust strategy accordingly.

After execution: If an unexpected situation is encountered (strategy became ineffective, page redesigned, anti-scraping upgraded, better path discovered), append a line: {YYYY-MM-DD}: {what happened} → {conclusion}

Normal execution does not write to the file. Do not record task inputs or result counts — those are task outputs, not experience.

© browser-act, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (scripts) in solutions/video-platforms/douyin-video-search of browser-act/skills.

  • SKILL.md
  • scripts/search-videos.py

Open the folder on GitHubat commit 11c057b

Compare with similar skills

Douyin Video Search next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Douyin Video Search compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Douyin Video Search this skillbrowser-act/skills6.1k—~1.8kAutomated safety check: PassMIT
Douyinsigcli/sigcli293—~696Automated safety check: NotesMIT
Google Maps ScraperMahanaicoach/google-maps-scraper-kit1.3k—~2.8kAutomated safety check: PassMIT
Douyin Creator ScrapingTradingAi666/TzFilm-Douyin-Tool406—~7.2kAutomated safety check: PassMIT
Media Crawlertsingyuai/growth-lab2k—~731Automated safety check: PassApache-2.0
Content Ideasbradautomates/content-ideas133—~5.4kAutomated safety check: NotesMIT

Similar skills

  • Douyin

    sigcli/sigcli

    Provide authenticated cookies for Douyin (抖音/TikTok China) — two providers: douyin (www.douyin.com for scraping) and douyin-live (live.douyin.com for livestream).

    293 GitHub stars~696 tokensUpdated 12 days ago
    Data & AnalyticsAuto-check: notes
  • Google Maps Scraper

    Mahanaicoach/google-maps-scraper-kit

    Scrape Google Maps business listings (name, address, phone, website, rating, reviews, lat/lng, hours, emails) via the local gosom google-maps-scraper REST API.

    1.3k GitHub stars~2.8k tokensUpdated 5 days ago
    Data & AnalyticsAuto-check passed
  • Douyin Creator Scraping

    TradingAi666/TzFilm-Douyin-Tool

    Scrape video stats from the Douyin creator center (creator.douyin.com) using AppleScript to automate the user's logged-in Chrome.

    406 GitHub stars~7.2k tokensUpdated 4 mo ago
    Data & AnalyticsAuto-check passed
  • Media Crawler

    tsingyuai/growth-lab

    Install, authenticate, configure, operate, and troubleshoot the external MediaCrawler client shared by Douyin, Kuaishou, Bilibili, Weibo, Tieba, and Zhihu collectors.

    2k GitHub stars~731 tokensUpdated 12 days ago
    Data & AnalyticsAuto-check passed
  • Content Ideas

    bradautomates/content-ideas

    Your For You page for content creators. An agent skill from bradautomates/content-ideas.

    133 GitHub stars~5.4k tokensUpdated 4 mo ago
    Data & AnalyticsAuto-check: notes
  • Catbus

    cv-cat/catbus

    用 catbus CLI 读取或操作小红书(RedNote)、抖音、TikTok、B 站(Bilibili)、快手、微博、闲鱼、淘宝、京东、X(Twitter)这 10 个平台:搜索、详情、评论、用户、推荐流、下载、发布、点赞关注、私信、直播弹幕,输出统一的 JSON。用户要查询、采集、导出、监听或操作这些平台上的内容和账号时使用。

    280 GitHub stars~986 tokensUpdated 3 days ago
    Data & AnalyticsAuto-check passed

More from browser-act/skills

All 87 skills in this repo
  • Amazon ASIN Lookup

    browser-act/skills

    Fetches structured Amazon product details such as title, price, ratings and availability for a given ASIN through BrowserAct's lookup API template.

    6.1k GitHub starsUsed in 1 repo~1.5k tokens
    Auto-check passed
  • Amazon Best Sellers Finder

    browser-act/skills

    Extracts structured Amazon product data for a keyword and marketplace through the BrowserAct API, including titles, prices, ratings, reviews, sales volume and promotions.

    6.1k GitHub starsUsed in 1 repo~1.5k tokens
    Auto-check passed
  • Amazon Buy Box Monitor

    browser-act/skills

    Pulls Amazon product details, competing seller prices and seller ratings for a given ASIN through the BrowserAct API, without browser automation.

    6.1k GitHub starsUsed in 1 repo~1.6k tokens
    Auto-check passed
  • Analyzes a competitor's Amazon listing by ASIN with BrowserAct data extraction, then reports what it does well, where the market has gaps and opportunity points for your own listing.

    6.1k GitHub starsUsed in 1 repo~3.2k tokens
    Auto-check passed
  • Pulls structured Amazon search results (titles, ASINs, prices, ratings, specifications) for a keyword and brand through BrowserAct's Amazon Product API template.

    6.1k GitHub starsUsed in 1 repo~1.5k tokens
    Auto-check passed
  • Collects structured product data from Amazon search results for a keyword and optional brand, using a BrowserAct script, for market and competitor research.

    6.1k GitHub starsUsed in 1 repo~1.6k tokens
    Auto-check passed

Works with

Questions about Douyin Video Search

What does Douyin Video Search do?

Searches Douyin (douyin.com) for videos by keyword and returns structured video data including author info, stats, cover, description, hashtags, and download URL. Douyin Video Search is an agent skill from browser-act/skills.com) for videos by keyword and returns structured video data including author info, stats, cover, description, hashtags, and download URL.

When should I use Douyin Video Search?

Douyin Video Search fits situations like: user mentions Douyin search; scrape Douyin videos; collect TikTok China videos; extract douyin video data.

How do I install Douyin Video Search in Claude Code?

Run `npx skills add browser-act/skills --skill douyin-video-search -a claude-code`. Or copy the skill folder (solutions/video-platforms/douyin-video-search in browser-act/skills) into .claude/skills/douyin-video-search in your project. Claude Code loads it when a task matches its description.

How do I install Douyin Video Search in Codex?

Run `npx skills add browser-act/skills --skill douyin-video-search -a codex`. Or copy the skill folder (solutions/video-platforms/douyin-video-search in browser-act/skills) into .agents/skills/douyin-video-search in your project. Codex loads it when a task matches its description.

Can I use Douyin Video Search in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add browser-act/skills --skill douyin-video-search -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/douyin-video-search, .gemini/skills/douyin-video-search, .github/skills/douyin-video-search and .opencode/skills/douyin-video-search in your project.

What does Douyin Video Search need to run?

Going by SKILL.md and its folder, Douyin Video Search needs Python for the scripts in its folder and the command-line tools its instructions call (python). Our summary lists: Python 3.

Does Douyin Video Search access the network?

SKILL.md names 2 domains. In commands or code: douyin.com and p3-pc-sign.douyinpic.com; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is Douyin Video Search safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Douyin Video Search use?

Douyin Video Search is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Douyin Video Search use?

About 1.8k tokens (SKILL.md is roughly 7.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Douyin Video Search?

Skills that share tags, products or a category with Douyin Video Search: Douyin (sigcli/sigcli, 293 stars), Google Maps Scraper (Mahanaicoach/google-maps-scraper-kit, 1.3k stars), Douyin Creator Scraping (TradingAi666/TzFilm-Douyin-Tool, 406 stars) and Media Crawler (tsingyuai/growth-lab, 2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Douyin Video Search?

browser-act (a GitHub organization) maintains it in browser-act/skills, which has 6,126 GitHub stars. The repository holds 87 skills in this directory. The repository was last updated on August 24, 2026.

Source: browser-act/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.