Agent skill

Tiktok Hashtag Videos

by browser-act in browser-act/skills

TikTok hashtag video scraper: input a hashtag name → output paginated video list with full metadata (author profile, engagement stats, music, video meta, hashtag list).

MITAuto-check passedData & Analytics

Install Tiktok Hashtag Videos

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

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

GitHub CLI
$ gh skill install browser-act/skills tiktok-hashtag-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-hashtag-videos .claude/skills/tiktok-hashtag-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-hashtag-videos
GitHub stars
6.1k
Token cost
~2k tokens
SKILL.md length
649 words
Files
2 (incl. scripts)
Skills in repo
87
Repo updated
First seen
Licence
MIT

At a glance

TikTok hashtag video scraper: input a hashtag name → output paginated video list with full metadata (author profile, engagement stats, music, video meta, hashtag list).

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

What it does

Tiktok Hashtag Videos is an agent skill from browser-act/skills. TikTok hashtag video scraper: input a hashtag name → output paginated video list with full metadata (author profile, engagement stats, music, video meta, hashtag list). Use when user mentions TikTok hashtag scraping, TikTok tag videos, scrape TikTok by hashtag, extract TikTok hashtag data, TikTok challenge videos, get videos from a TikTok tag, bulk collect TikTok hashtag posts, TikTok video collection by tag, TikTok topic videos, collect TikTok tag data, batch fetch TikTok videos by hashtag, tiktok tag scraper…

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

It sits in Data & Analytics, covering Web scraping. It works with TikTok and Python. 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 hashtag scraping
  • TikTok tag videos
  • Scrape TikTok by hashtag
  • Extract TikTok hashtag data

Example prompts

  • “/tiktok-hashtag-videos”

Requirements

  • Python 3

Workflow steps

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

  1. navigate https://www.tiktok.com/tag/{hashtag}
  2. wait stable
  3. network requests --type xhr,fetch --filter "challenge/item_list"
  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

    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:

    • 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 Hashtag Videos loads about 2k tokens when it runs. Until then it costs about 196 tokens; SKILL.md has 649 words of instructions outside code blocks.

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

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). 649 words, ~1,957 tokens.

Download SKILL.mdSave it as .claude/skills/tiktok-hashtag-videos/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
tiktok-hashtag-videos
description
TikTok hashtag video scraper: input a hashtag name → output paginated video list with full metadata (author profile, engagement stats, music, video meta, hashtag list). Use when user mentions TikTok hashtag scraping, TikTok tag videos, scrape TikTok by hashtag, extract TikTok hashtag data, TikTok challenge videos, get videos from a TikTok tag, bulk collect TikTok hashtag posts, TikTok video collection by tag, TikTok topic videos, collect TikTok tag data, batch fetch TikTok videos by hashtag, tiktok tag scraper, tiktok challenge scraper. Also applies to competitive research on TikTok trending topics, influencer discovery by hashtag, content monitoring for specific TikTok tags, or any task requiring video lists from a specific TikTok hashtag or challenge.

TikTok — Hashtag Videos

hashtag name → challenge info + 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 the video list for a given TikTok hashtag using the /api/challenge/item_list/ endpoint triggered by page navigation.

Prerequisites

  • Browser is open and can access https://www.tiktok.com
  • No login required for public hashtag data
  • Browser must use a non-HK proxy (TikTok has shut down in Hong Kong)

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.

Below are all atomic capabilities discovered and verified during the exploration phase. Simply invoke them as needed — no need to read scripts/*.py source code or re-verify.

API: Get challenge ID from hashtag name

eval "$(python scripts/get-challenge-id.py '{hashtag}')"

Parameters:

  • {hashtag}: hashtag name without #, e.g., fitness

Output example:

json
{
  "id": "9261",             // challengeID — required for item_list requests
  "title": "fitness",       // canonical hashtag title
  "videoCount": "63107035", // total videos under this hashtag
  "viewCount": "760591731095" // total views
}
Network Capture: Hashtag video list (parameters injected via URL navigation)

/api/challenge/item_list/ requires TikTok's dynamic signing (X-Bogus/X-Gnarly); direct fetch returns empty. Navigate to the hashtag page — TikTok's JS triggers the signed request automatically:

  1. navigate https://www.tiktok.com/tag/{hashtag}
  2. wait stable
  3. network requests --type xhr,fetch --filter "challenge/item_list"
  4. network request <id>

Endpoint characteristic: URL contains /api/challenge/item_list/ with cursor=0

Error handling: If no matching request is found after navigation, take a screenshot to confirm the page loaded correctly, then retry navigation once. If the page shows a region-restriction notice, switch to a browser with a non-HK proxy.

Output example:

json
{
  "cursor": "30",   // use as cursor value to identify next page's request
  "hasMore": true,  // false when all pages exhausted
  "itemList": [
    {
      "id": "7212410220977392938",
      "desc": "Daily Push Up Workout🚀#fitness #athlete",
      "createTime": 1679270124,
      "isAd": false,
      "isPinned": false,
      "locationCreated": "US",
      "author": {
        "uniqueId": "marcusriosofficial",  // username for webVideoUrl
        "nickname": "Marcus Rios",
        "verified": false,
        "signature": "Former NFL Athlete 🏈",
        "bioLink": null,
        "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": [],
      "imagePost": null  // non-null for slideshow posts
    }
  ]
}
Network Capture: Hashtag video list pagination (page 2+)

After reading page 1, scroll down to trigger the next page request:

  1. scroll down
  2. wait stable
  3. network requests --type xhr,fetch --filter "challenge/item_list"
  4. Find the request whose URL contains a cursor value higher than the previous page (e.g., cursor=30, cursor=60)
  5. network request <id>

Termination: hasMore is false in response, or itemList is empty.

Show full SKILL.md (263 more words)Show less
Composite: Full hashtag extraction (challenge ID + paginated video list)
  1. eval "$(python scripts/get-challenge-id.py '{hashtag}')" → record id as challengeId (confirms hashtag exists)
  2. navigate https://www.tiktok.com/tag/{hashtag} → wait stable
  3. network requests --filter "challenge/item_list" → network request <id> → collect itemList, note cursor and hasMore
  4. While hasMore is true: a. scroll down → wait stable b. network requests --filter "challenge/item_list" → find new request (cursor changed) → network request <id> c. Collect itemList, update hasMore
  5. Merge all collected itemList arrays

Pagination

DOM Pagination: Scroll triggers new challenge/item_list requests. Each page returns 30 items. Cursor advances numerically (0 → 30 → 60...). Termination: hasMore === false or empty itemList.

Success Criteria

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

Known Limitations

  • Requires non-HK proxy (TikTok shut down in Hong Kong)
  • challenge/item_list requires dynamic signing — always use navigate + network capture
  • get-challenge-id.py (challenge/detail) works via direct fetch without signing
  • Private or age-restricted hashtags may return empty itemList
  • Page returns ~30 videos per scroll; high-volume extraction requires many scroll iterations

Execution Efficiency

  • Batch orchestration: Loop through multiple hashtags serially in one session; do not parallelize within one browser. Add 2–3s intervals between navigations.
  • Test before batch execution: Test with 1 hashtag first, then run the full batch.
  • Error resumption: Save results page-by-page; resume from the last successful page on failure.

Experience Notes

Path: {working-directory}/browser-act-skill-forge-memories/tiktok-scraper-tiktok-hashtag-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, better path found), 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

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

  • SKILL.md
  • scripts/get-challenge-id.py

Open the folder on GitHubat commit 11c057b

Compare with similar skills

Tiktok Hashtag 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 Hashtag Videos compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Tiktok Hashtag Videos this skillbrowser-act/skills6.1k—~2kAutomated safety check: PassMIT
Google Maps ScraperMahanaicoach/google-maps-scraper-kit1.3k—~2.8kAutomated safety check: PassMIT
Boss Zhipin Scrapereatmoreduck/boss-zhipin-scraper1.5k—~2.6kAutomated safety check: PassMIT
Crawl4AI Web Scrapingsmallnest/goclaw5991 repos~2.5kAutomated safety check: PassMIT
Axyusukebe/ax7191 repos~918Automated safety check: PassMIT
Python Executorcortega26/chile-hub1132 repos~1.5kAutomated safety check: PassMIT

Similar skills

  • 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
  • Boss Zhipin Scraper

    eatmoreduck/boss-zhipin-scraper

    Scrape BOSS直聘 (job listing site) via Chrome CDP. An agent skill from eatmoreduck/boss-zhipin-scraper.

    1.5k GitHub stars~2.6k tokensUpdated today
    Data & AnalyticsAuto-check passed
  • Crawl4AI Web Scraping

    smallnest/goclaw

    Scrapes sites, handles JavaScript-heavy pages and extracts structured data with Crawl4AI, through its crwl CLI or Python SDK, including schema-based extraction without an LLM.

    599 GitHub starsUsed in 1 repo~2.5k tokens
    Data & AnalyticsAuto-check passed
  • Ax

    yusukebe/ax

    Use the ax CLI instead of curl + throwaway parsing scripts whenever you fetch a URL, explore an unknown web page, or extract structured data from HTML.

    719 GitHub starsUsed in 1 repo~918 tokens
    Data & AnalyticsAuto-check passed
  • Python Executor

    cortega26/chile-hub

    Execute Python code in a safe sandboxed environment via [inference.sh](https://inference.sh).

    113 GitHub starsUsed in 2 repos~1.5k tokens
    Data & AnalyticsAuto-check passed
  • Scrapling

    Cedriccmh/claude-code-skill-scrapling

    使用 scrapling 进行网页抓取和数据提取。根据目标网站特征自动选择最佳 Fetcher, 生成并执行 Python 脚本完成任务。Use when: (1) 抓取/爬取网页内容或数据(scrape, crawl, fetch page, extract data) (2) 需要绕过 Cloudflare/WAF 等反爬保护 (3) 登录后抓取受保护页面 (4) 解析已有 HTML…

    446 GitHub stars~1.1k tokensUpdated 3 mo 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 Tiktok Hashtag Videos

What does Tiktok Hashtag Videos do?

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

When should I use Tiktok Hashtag Videos?

Tiktok Hashtag Videos fits situations like: user mentions TikTok hashtag scraping; tikTok tag videos; scrape TikTok by hashtag; extract TikTok hashtag data.

How do I install Tiktok Hashtag Videos in Claude Code?

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

How do I install Tiktok Hashtag Videos in Codex?

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

Can I use Tiktok Hashtag 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-hashtag-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-hashtag-videos, .gemini/skills/tiktok-hashtag-videos, .github/skills/tiktok-hashtag-videos and .opencode/skills/tiktok-hashtag-videos in your project.

What does Tiktok Hashtag Videos need to run?

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

Does Tiktok Hashtag 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 Hashtag 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Tiktok Hashtag Videos use?

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

About 2k tokens (SKILL.md is roughly 7.8k 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 Hashtag Videos?

Skills that share tags, products or a category with Tiktok Hashtag Videos: Google Maps Scraper (Mahanaicoach/google-maps-scraper-kit, 1.3k stars), Boss Zhipin Scraper (eatmoreduck/boss-zhipin-scraper, 1.5k stars), Crawl4AI Web Scraping (smallnest/goclaw, 599 stars) and Ax (yusukebe/ax, 719 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Tiktok Hashtag 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.