Agent skill

Tiktok Search Videos

by browser-act in browser-act/skills

TikTok keyword search video scraper: input search keyword → output paginated video list with full metadata (author, engagement stats, music, video meta).

MITAuto-check passedData & Analytics

Install Tiktok Search Videos

skills CLI
$ npx skills add browser-act/skills --skill tiktok-search-videos -a claude-code

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

GitHub CLI
$ gh skill install browser-act/skills tiktok-search-videos --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/tiktok-search-videos .claude/skills/tiktok-search-videos && 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
tiktok-search-videos
GitHub stars
6.1k
Token cost
~1.6k tokens
SKILL.md length
539 words
Files
1
Skills in repo
87
Repo updated
First seen
Licence
MIT

At a glance

TikTok keyword search video scraper: input search keyword → output paginated video list with full metadata (author, engagement stats, music, video meta).

  • Works in 4 steps: navigate… → wait stable → network requests --type xhr,fetch… → …
  • User mentions TikTok search scraping
  • SKILL.md covers Language, Objective, Prerequisites and Pre-execution Checks, plus 6 more sections
  • Calls python; reaches tiktok.com

What it does

Tiktok Search Videos is an agent skill from browser-act/skills. TikTok keyword search video scraper: input search keyword → output paginated video list with full metadata (author, engagement stats, music, video meta). Use when user mentions TikTok search scraping, search TikTok by keyword, TikTok search results, extract TikTok search data, scrape TikTok videos by keyword, TikTok keyword videos, TikTok keyword search, TikTok search results collection, find TikTok videos by topic, tiktok search scraper, tiktok keyword scraper. Also applies to market research on TikTok content…

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Data & Analytics, covering Web scraping. It works with 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 TikTok search scraping
  • Search TikTok by keyword
  • TikTok search results
  • Extract TikTok search data

Example prompts

  • “/tiktok-search-videos”

Requirements

  • Python 3

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. navigate https://www.tiktok.com/search/video?q={keyword}
  2. wait stable
  3. network requests --type xhr,fetch --filter "search/item/full"
  4. network request

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

    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:

    • tiktok.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

Tiktok Search Videos loads about 1.6k tokens when it runs. Until then it costs about 161 tokens; SKILL.md has 539 words of instructions outside code blocks.

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

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); files beside SKILL.md are not scanned.

SKILL.md

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

Download SKILL.mdSave it as .claude/skills/tiktok-search-videos/SKILL.md (or your agent's skills folder).
name
tiktok-search-videos
description
TikTok keyword search video scraper: input search keyword → output paginated video list with full metadata (author, engagement stats, music, video meta). Use when user mentions TikTok search scraping, search TikTok by keyword, TikTok search results, extract TikTok search data, scrape TikTok videos by keyword, TikTok keyword videos, TikTok keyword search, TikTok search results collection, find TikTok videos by topic, tiktok search scraper, tiktok keyword scraper. Also applies to market research on TikTok content for specific topics, competitor content monitoring, or discovering videos and creators around a keyword.

TikTok — Search Videos

search keyword → paginated video list with author, engagement, music, and video metadata

Language

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

Objective

Extract TikTok video search results for a given keyword using the /api/search/item/full/ endpoint triggered by navigating to the search results page.

Prerequisites

  • Browser is open and can access https://www.tiktok.com
  • Login required: TikTok blocks video search API for non-logged-in users; ensure the browser has an active TikTok session

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.

Capability Components

This Skill's operational boundary = what the user can manually do in their browser. It only reads data already displayed to the user on the page, never bypassing authentication or access controls. JS code is encapsulated in Python files under the scripts/ directory, invoked via eval "$(python scripts/xxx.py {params})". $(...) is bash syntax; it is recommended to use the bash tool for execution.

Network Capture: Search video results (parameters injected via URL navigation)

/api/search/item/full/ requires TikTok's dynamic signing; navigate to the search page to trigger it automatically:

  1. navigate https://www.tiktok.com/search/video?q={keyword}
  2. wait stable
  3. network requests --type xhr,fetch --filter "search/item/full"
  4. network request <id>

Endpoint characteristic: URL contains /api/search/item/full/ with keyword={keyword}&cursor=0

Error handling: If no matching request appears after navigation, take a screenshot to verify the page loaded correctly (check for anti-bot challenge), then retry once.

Output example:

json
{
  "status_code": 0,
  "cursor": "12",    // use to identify next-page requests
  "has_more": 1,     // 0 when all results exhausted
  "item_list": [
    {
      "id": "7212410220977392938",
      "desc": "Daily Push Up Workout🚀#fitness #athlete",
      "createTime": 1679270124,
      "isAd": false,
      "locationCreated": "US",
      "author": {
        "uniqueId": "marcusriosofficial",
        "nickname": "Marcus Rios",
        "verified": false,
        "signature": "Former NFL Athlete 🏈",
        "avatarThumb": "https://...",
        "privateAccount": false
      },
      "authorStats": {
        "followerCount": 423500,
        "followingCount": 50,
        "heart": 10000000,
        "videoCount": 1277,
        "diggCount": 869
      },
      "stats": {
        "diggCount": 367500,
        "shareCount": 6041,
        "playCount": 4500000,
        "commentCount": 942,
        "collectCount": 56691
      },
      "video": {
        "duration": 48,
        "height": 1280,
        "width": 720,
        "cover": "https://...",
        "definition": "720p",
        "format": "mp4"
      },
      "music": {
        "id": "7176546707423889410",
        "title": "Trap Money so Big (Remix)",
        "authorName": "Iqbal12",
        "original": false,
        "coverMedium": "https://..."
      },
      "textExtra": [{"hashtagId": "9261", "hashtagName": "fitness"}],
      "effectStickers": []
    }
  ]
}

To build the webVideoUrl for each item: https://www.tiktok.com/@{item.author.uniqueId}/video/{item.id}

Network Capture: Search results pagination (page 2+)

After reading page 1, scroll down to load the next page:

  1. scroll down
  2. wait stable
  3. network requests --type xhr,fetch --filter "search/item/full"
  4. Find the request where the URL cursor value is higher than the previous page (e.g., cursor=12, cursor=24)
  5. network request <id>

Termination: has_more is 0 in response, or item_list is empty.

Show full SKILL.md (214 more words)Show less

Pagination

DOM Pagination: Scroll triggers new search/item/full requests. Each page returns 12 items. Cursor increments by 12 per page. Termination: has_more === 0 or empty item_list.

Success Criteria

item_list.length >= 1 and first item has non-null id, stats.playCount, author.uniqueId

Known Limitations

  • search/item/full requires dynamic signing — always use navigate + network capture
  • Login required: TikTok blocks the video search API for non-logged-in users — search/item/full will not be triggered without an active TikTok session; exploration was done on a logged-in browser and this dependency was not caught at the time
  • Search returns ~12 videos per page (fewer than hashtag's 30 per page)
  • Logged-in users may see personalized results; use a fresh browser session for unbiased results
  • searchQuery field is not returned in the raw API response body

Execution Efficiency

  • Batch orchestration: Loop multiple keywords serially in one session; add 2–3s between navigations.
  • Test before batch execution: Test with 1 keyword first before running the full list.
  • Error resumption: Save results keyword-by-keyword; resume from the failed keyword on error.

Experience Notes

Path: {working-directory}/browser-act-skill-forge-memories/tiktok-scraper-tiktok-search-videos.memory.md

Before execution: If the file exists, read it first — it records unexpected situations from past executions; adjust strategy accordingly.

After execution: If an unexpected situation occurs (strategy failed, page redesigned, anti-scraping upgraded), append a line: {YYYY-MM-DD}: {what happened} → {conclusion}

Normal execution does not write to the file.

© 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

Just SKILL.md in solutions/video-platforms/tiktok-search-videos of browser-act/skills.

Open the folder on GitHubat commit 11c057b

Compare with similar skills

Tiktok Search Videos 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.

Tiktok Search Videos compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Tiktok Search Videos this skillbrowser-act/skills6.1k—~1.6kAutomated safety check: PassMIT
Data Feedsbrightdata/skills264—~2.2kAutomated safety check: PassMIT
Apify Content Analyticssickn33/agentic-awesome-skills47k2 repos~1.2kAutomated safety check: NotesMIT
Apify Competitor IntelligenceaAAaqwq/AGI-Super-Team1053 repos~1.3kAutomated safety check: NotesMIT
Apify Creator Emailsapify/awesome-skills266—~3.9kAutomated safety check: PassApache-2.0
Google Maps ScraperMahanaicoach/google-maps-scraper-kit1.3k—~2.8kAutomated safety check: PassMIT

Similar skills

  • Data Feeds

    brightdata/skills

    Extract structured data from 40+ supported platforms (Amazon, LinkedIn, Instagram, TikTok, Facebook, YouTube, Reddit, and more) via the Bright Data CLI (bdata pipelines).

    264 GitHub stars~2.2k tokensUpdated 4 days ago
    Data & AnalyticsAuto-check passed
  • Apify Content Analytics

    sickn33/agentic-awesome-skills

    Track engagement metrics, measure campaign ROI, and analyze content performance across Instagram, Facebook, YouTube, and TikTok.

    47k GitHub starsUsed in 2 repos~1.2k tokens
    Data & AnalyticsAuto-check: notes
  • Apify Competitor Intelligence

    aAAaqwq/AGI-Super-Team

    Analyze competitor strategies, content, pricing, ads, and market positioning across Google Maps, Booking.com, Facebook, Instagram, YouTube, and TikTok.

    105 GitHub starsUsed in 3 repos~1.3k tokens
    Data & AnalyticsAuto-check: notes
  • Apify Creator Emails

    apify/awesome-skills

    Official

    Find creators and their published contact emails in one run.

    266 GitHub stars~3.9k tokensUpdated 18 days ago
    Data & AnalyticsAuto-check passed
  • 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 6 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

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 Tiktok Search Videos

What does Tiktok Search Videos do?

TikTok keyword search video scraper: input search keyword → output paginated video list with full metadata (author, engagement stats, music, video meta). Tiktok Search Videos is an agent skill from browser-act/skills. TikTok keyword search video scraper: input search keyword → output paginated video list with full metadata (author, engagement stats, music, video meta).

When should I use Tiktok Search Videos?

Tiktok Search Videos fits situations like: user mentions TikTok search scraping; search TikTok by keyword; tikTok search results; extract TikTok search data.

How do I install Tiktok Search Videos in Claude Code?

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

How do I install Tiktok Search Videos in Codex?

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

Can I use Tiktok Search Videos 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 tiktok-search-videos -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/tiktok-search-videos, .gemini/skills/tiktok-search-videos, .github/skills/tiktok-search-videos and .opencode/skills/tiktok-search-videos in your project.

What does Tiktok Search Videos need to run?

Going by SKILL.md and its folder, Tiktok Search Videos needs the command-line tools its instructions call (python). Our summary lists: Python 3.

Does Tiktok Search Videos access the network?

SKILL.md names 1 domain. In commands or code: tiktok.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Tiktok Search Videos 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. Review the folder before installing.

What licence does Tiktok Search Videos use?

Tiktok Search Videos 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 Tiktok Search Videos use?

About 1.6k tokens (SKILL.md is roughly 6.3k 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 Tiktok Search Videos?

Skills that share tags, products or a category with Tiktok Search Videos: Data Feeds (brightdata/skills, 264 stars), Apify Content Analytics (sickn33/agentic-awesome-skills, 47k stars), Apify Competitor Intelligence (aAAaqwq/AGI-Super-Team, 105 stars) and Apify Creator Emails (apify/awesome-skills, 266 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Tiktok Search Videos?

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.