Agent skill

Bggg Tiktok Search

by binggandata in binggandata/bggg-skills

使用本地真实 Chrome 登录态做 TikTok 调研,支持 WebBridge、Chrome/CDP、Apple Events 或人工辅助路径。

MITAuto-check passedDocuments & Office

Install Bggg Tiktok Search

skills CLI
$ npx skills add binggandata/bggg-skills --skill bggg-tiktok-search -a claude-code

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

GitHub CLI
$ gh skill install binggandata/bggg-skills bggg-tiktok-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/binggandata/bggg-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/bggg-tiktok-search .claude/skills/bggg-tiktok-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
bggg-tiktok-search
GitHub stars
605
Token cost
~1.5k tokens
SKILL.md length
170 words
Files
10 (incl. scripts, references)
Skills in repo
13
Repo updated
First seen
Licence
MIT

At a glance

使用本地真实 Chrome 登录态做 TikTok 调研,支持 WebBridge、Chrome/CDP、Apple Events 或人工辅助路径。

  • Works in 5 steps: 打开 TikTok 并搜索关键词 → 提取视频卡片数据 → 截图留证 → …
  • Tasks that involve CSV and tabular files
  • SKILL.md covers 目标, 前置条件, 工作流 and WebBridge 操作示例, plus 3 more sections
  • Runs Python scripts from its folder; calls curl and python3; reaches tiktok.com

What it does

Bggg Tiktok Search is an agent skill from binggandata/bggg-skills. 使用本地真实 Chrome 登录态做 TikTok 调研,支持 WebBridge、Chrome/CDP、Apple Events 或人工辅助路径。 当用户要求在 TikTok 上搜索关键词、搜索博主、采样视频、打开博主主页、 采集最近作品、提取视频链接/标题/作者/互动指标、截图留证、 输出 CSV/Markdown/JSON 调研包,或做 TikTok 博主/内容/选题/带货方向研究时, 使用此 skill。它不依赖第三方 TikTok API,核心原则是只做可见页面读取、滚动、截图和结构化整理。

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 13 other files, including scripts and reference files (for example `README.md`, `README_EN.md` and `evals/evals.json`).

It sits in Documents & Office, covering CSV and tabular files. It works with TikTok. The repository describes itself as: Open-source Codex skills from BGGG. The licence is MIT.

When your agent uses it

  • Tasks that involve CSV and tabular files

Example prompts

  • “/bggg-tiktok-search”

Requirements

  • Python 3

Workflow steps

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

  1. 打开 TikTok 并搜索关键词
  2. 提取视频卡片数据
  3. 截图留证
  4. 滚动加载更多
  5. 打开博主主页采集作品

What it can do on your machine

Read from SKILL.md and the folder at commit 1034ee5. 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 3 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • curl
    • python3

    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

Bggg Tiktok Search loads about 1.5k tokens when it runs, and up to ~3.6k if it reads all its reference files. Until then it costs about 68 tokens; SKILL.md has 170 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~68
When it runs · the whole SKILL.md, loaded when a task matches
~1.5k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.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); the scripts in this folder are not scanned.

SKILL.md

The full file from binggandata/bggg-skills at commit 1034ee5, republished under its MIT licence (© binggandata). 170 words, ~1,462 tokens.

Download SKILL.mdSave it as .claude/skills/bggg-tiktok-search/SKILL.md (or your agent's skills folder). This skill also uses 9 other files; get the full folder from GitHub.
name
bggg-tiktok-search
description
使用本地真实 Chrome 登录态做 TikTok 调研,支持 WebBridge、Chrome/CDP、Apple Events 或人工辅助路径。 当用户要求在 TikTok 上搜索关键词、搜索博主、采样视频、打开博主主页、 采集最近作品、提取视频链接/标题/作者/互动指标、截图留证、 输出 CSV/Markdown/JSON 调研包,或做 TikTok 博主/内容/选题/带货方向研究时, 使用此 skill。它不依赖第三方 TikTok API,核心原则是只做可见页面读取、滚动、截图和结构化整理。

目标

用用户本地真实 Chrome 的 TikTok 登录态完成内容调研、博主搜索、视频采样、主页采集和截图留证。默认只读取公开或用户可见页面,不做点赞、关注、评论、私信、发布或账号设置修改。

前置条件

任选一种控制路径:

  1. WebBridge:本地 WebBridge daemon 和浏览器扩展可用。
  2. Chrome/CDP:用户自己启动带 remote debugging 的 Chrome,脚本通过 Playwright 连接。
  3. Apple Events:macOS Chrome 开启 View > Developer > Allow JavaScript from Apple Events 后使用 scripts/tk_real_chrome.py。
  4. 手动辅助:当登录、验证码、地区弹窗或风控出现时,让用户在真实 Chrome 里处理后继续。

WebBridge 健康检查:

bash
WEBBRIDGE_URL="${WEBBRIDGE_URL:-http://127.0.0.1:10086}"
curl -s "$WEBBRIDGE_URL/status"

CDP 健康检查:

bash
python3 <skill-dir>/scripts/tk_research.py check-cdp

工作流

  1. 判断任务类型:
    • 关键词找视频 → search
    • 关键词找博主 → authors
    • 已有博主主页 → creator
    • 用户已经把 Chrome 打到目标页 → current
  2. 操作 Chrome:
    • navigate 打开 TikTok 搜索页/博主页。
    • fill 输入搜索词,click 触发搜索。
    • snapshot 读取页面内容,定位视频卡片。
    • evaluate 提取结构化数据(URL、作者、标题、互动数)。
    • 截图留证,避免把 base64 截图直接贴进上下文。
    • 滚动加载更多,重复提取。
  3. 结果保存:
    • 结构化数据写入 collected_items.json。
    • 截图保存到 screenshots/。
    • 生成 research_notes.md 做业务蒸馏。
  4. 后续衔接:
    • 要下载视频 → 交给 bggg-tiktok-downloader
    • 要分析视频 → 交给 bggg-tiktok-readvideo

WebBridge 操作示例

1. 打开 TikTok 并搜索关键词
bash
# 打开 TikTok 首页(新标签页,session 隔离)
curl -s -X POST "$WEBBRIDGE_URL/command" \
  -H 'Content-Type: application/json' \
  -d '{"action":"navigate","args":{"url":"https://www.tiktok.com","newTab":true,"group_title":"TikTok Research"},"session":"tiktok-search"}'

# 获取页面 snapshot,找到搜索框的 @e ref
curl -s -X POST "$WEBBRIDGE_URL/command" \
  -d '{"action":"snapshot","session":"tiktok-search"}'

# 在搜索框填入关键词(用 @e ref 或 CSS selector)
curl -s -X POST "$WEBBRIDGE_URL/command" \
  -d '{"action":"fill","args":{"selector":"input[type=search]","value":"skincare routine"},"session":"tiktok-search"}'

# 点击搜索按钮或按回车
curl -s -X POST "$WEBBRIDGE_URL/command" \
  -d '{"action":"click","args":{"selector":"button[type=submit]"},"session":"tiktok-search"}'
2. 提取视频卡片数据
bash
# 用 evaluate 提取视频列表的结构化数据
curl -s -X POST "$WEBBRIDGE_URL/command" \
  -d '{"action":"evaluate","args":{"code":"(() => { const cards = [...document.querySelectorAll(\"[data-e2e=search-card-video]\")].slice(0, 10); return cards.map((c, i) => { const link = c.querySelector(\"a\"); const author = c.querySelector(\"[data-e2e=search-card-user-avatar]\"); const metrics = [...c.querySelectorAll(\"[data-e2e=video-views]\")]; return { index: i, url: link ? link.href : null, title: c.innerText.slice(0, 200), author: author ? author.getAttribute(\"href\") : null, raw_text: c.innerText.slice(0, 500) }; }); })()"},"session":"tiktok-search"}'

TikTok DOM 经常变化,上面的 selector 只是示例。实际使用时先用 snapshot 读当前页面结构,再写对应的 evaluate 提取逻辑。

3. 截图留证
bash
python3 <skill-dir>/scripts/tk_research.py screenshot "search_001"
4. 滚动加载更多
bash
curl -s -X POST "$WEBBRIDGE_URL/command" \
  -d '{"action":"evaluate","args":{"code":"window.scrollTo(0, document.body.scrollHeight); return document.body.scrollHeight;"},"session":"tiktok-search"}'

滚动后等待 2-3 秒让内容加载,再 snapshot 或 evaluate 提取新出现的卡片。

5. 打开博主主页采集作品
bash
# 导航到博主主页
curl -s -X POST "$WEBBRIDGE_URL/command" \
  -d '{"action":"navigate","args":{"url":"https://www.tiktok.com/@creator","newTab":true},"session":"tiktok-creator"}'

# 提取主页视频列表
curl -s -X POST "$WEBBRIDGE_URL/command" \
  -d '{"action":"evaluate","args":{"code":"(() => { const items = [...document.querySelectorAll(\"[data-e2e=user-post-item]\")].slice(0, 10); return items.map((item, i) => { const link = item.querySelector(\"a\"); const views = item.querySelector(\"[data-e2e=video-views]\"); return { index: i, url: link ? link.href : null, title: item.innerText.slice(0, 100), views: views ? views.innerText : null, raw_text: item.innerText.slice(0, 300) }; }); })()"},"session":"tiktok-creator"}'

输出目录结构

text
bggg-tiktok-search/projects/tiktok-research/YYYYMMDD_HHMMSS_<slug>/
├── collected_items.json
├── research_notes.md
└── screenshots/
    ├── search_001.png
    ├── search_002.png
    └── ...
collected_items.json 结构
json
{
  "method": "kimi-webbridge",
  "query": "skincare routine",
  "source_url": "https://www.tiktok.com/search?q=skincare%20routine",
  "session": "tiktok-search",
  "items": [
    {
      "url": "https://www.tiktok.com/@creator/video/1234567890123456789",
      "author": "@creator",
      "author_url": "https://www.tiktok.com/@creator",
      "title": "visible caption or card text",
      "metric_1": "visible metric",
      "metric_2": "visible metric",
      "date": "visible date",
      "raw_text": "short visible evidence",
      "screenshot": "screenshots/search_001.png",
      "notes": "why this item matters"
    }
  ]
}

调研输出建议

最终回复用户时优先给:

  1. 调研包路径:JSON、CSV、Markdown、截图。
  2. 最高价值候选视频或博主列表。
  3. 内容结构洞察:选题、开头钩子、账号定位、带货意图、镜头/话术模式。
  4. 下一步建议:是否进入下载、转写、深度拆解或飞书多维表格沉淀。

注意事项

  • TikTok DOM 经常变化,evaluate 里的 selector 需要按实际页面结构调整。先用 snapshot 确认当前结构再写提取逻辑。
  • 遇到登录、风控、地区限制或验证码,让用户在真实 Chrome 里手动处理后继续。不要代解 CAPTCHA。
  • 不做点赞、关注、评论、发私信、发帖、改账号设置等外部副作用动作;如果用户明确要求,动作前必须确认。
  • 不要提交 Cookie、浏览器 profile、截图、CSV、JSON 采集结果或任何运行产物到公开仓库。
  • 截图文件写到 projects/tiktok-research/.../screenshots/;不要把 base64 截图直接贴进上下文。
  • 任务结束后关闭 session:
    bash
    curl -s -X POST "$WEBBRIDGE_URL/command" \
      -d '{"action":"close_session","session":"tiktok-search"}'
  • references/implementation-notes.md 记录了从其他 browser-use skill 学到的设计模式;第三方参考项目不随本 skill vendored。

更多实现细节按需读取 references/implementation-notes.md。

© binggandata, 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 9 other files (scripts, references) in bggg-tiktok-search of binggandata/bggg-skills.

  • SKILL.md
  • README.md
  • README_EN.md
  • evals/evals.json
  • projects/.gitkeep
  • references/codex-browser-workflows.md
  • references/implementation-notes.md
  • scripts/__init__.py
  • scripts/tk_real_chrome.py
  • scripts/tk_research.py

Open the folder on GitHubat commit 1034ee5

Compare with similar skills

Bggg Tiktok 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.

Bggg Tiktok Search compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Bggg Tiktok Search this skillbinggandata/bggg-skills605—~1.5kAutomated safety check: PassMIT
Overseas Trending Searchredfox-data/redfox-community427—~1.4kAutomated safety check: PassNone
Data Table Managern8n-io/n8n207k—~2.3kAutomated safety check: PassCustom licence
Instrument Data To Allotropeaws-samples/amazon-bedrock-agents-healthcare-lifesciences2742 repos~2.7kAutomated safety check: PassApache-2.0
Abuse Hunternexu-io/harness-engineering-guide664—~1.9kAutomated safety check: PassMIT
Intelligence Requirements BuilderTracecatHQ/tracecat3.8k—~6kAutomated safety check: PassMIT

Similar skills

  • Overseas Trending Search

    redfox-data/redfox-community

    海外跨平台热文搜索 — 输入任意关键词(中文/英文),一次搜索 X / TikTok / YouTube 三平台热门内容,每平台 Top N(默认5)统一列表(平台/标题/作者/播放/点赞/评论/发布时间/链接),终端分组表格 + CSV 导出 + 交互式 HTML…

    427 GitHub stars~1.4k tokensUpdated yesterday
    Documents & OfficeAuto-check passed
  • Official

    Load before calling data-tables or parse-file. An agent skill from n8n-io/n8n.

    207k GitHub stars~2.3k tokensUpdated today
    Documents & OfficeAuto-check passed
  • Instrument Data To Allotrope

    aws-samples/amazon-bedrock-agents-healthcare-lifesciences

    Official

    Convert laboratory instrument output files (PDF, CSV, Excel, TXT) to Allotrope Simple Model (ASM) JSON format or flattened 2D CSV.

    274 GitHub starsUsed in 2 repos~2.7k tokens
    Documents & OfficeAuto-check passed
  • Abuse Hunter

    nexu-io/harness-engineering-guide

    Detect and investigate bulk registration abuse on SaaS platforms.

    664 GitHub stars~1.9k tokensUpdated 5 mo ago
    Documents & OfficeAuto-check passed
  • Turns a vague, high-level stakeholder ask into a structured set of intelligence requirements for a CTI team, complete with Essential Elements of Information, collection guidance, success criteria…

    3.8k GitHub stars~6k tokensUpdated today
    Documents & OfficeAuto-check passed
  • Markit

    shift-labs-ai/markit

    Convert files and URLs to Markdown. An agent skill from shift-labs-ai/markit.

    1.3k GitHub stars~299 tokensUpdated 1 mo ago
    Documents & OfficeAuto-check passed

More from binggandata/bggg-skills

All 13 skills in this repo
  • Bggg Data Amazon

    binggandata/bggg-skills

    Collect Amazon.com written product reviews at scale through Woot's public review AJAX route, retain every attempt and error log, reconcile partial runs, and normalize exact review text into…

    605 GitHub stars~1.4k tokensUpdated 1 mo ago
    Auto-check passed
  • Bggg Data Reddit

    binggandata/bggg-skills

    Collect auditable Reddit search results and full comment trees at scale, preserve the source JSON, and normalize posts and comments into analysis-ready JSONL.

    605 GitHub stars~1.2k tokensUpdated 1 mo ago
    Auto-check passed
  • Bggg Data X

    binggandata/bggg-skills

    Collect auditable public X/Twitter posts by controlling the user's already logged-in Chrome, searching X's rendered web interface, scrolling visible results, and extracting original post text and…

    605 GitHub stars~1.5k tokensUpdated 1 mo ago
    Auto-check passed
  • Ngs Amazon Image Studio

    binggandata/bggg-skills

    Generate Amazon and cross-border ecommerce product images from a product business card.

    605 GitHub stars~2.4k tokensUpdated 1 mo ago
    Auto-check passed
  • Bggg Tiktok Capcut

    binggandata/bggg-skills

    通用 CapCut 草稿生成与 AI 视频检查 skill。用于把本地 AI 视频套用现有 CapCut 草稿模板, 生成可在 CapCut 首页显示并可编辑的新草稿;也用于提取模板样式、验证草稿结构、抽帧检查 AI 痕迹、规划修复窗口和做本地 RIFE 补帧。

    605 GitHub stars~854 tokensUpdated 1 mo ago
    Auto-check passed
  • Bggg Tiktok Cut

    binggandata/bggg-skills

    用于把 AI 生成的视频、本地素材、口播素材或产品短片剪成可发布到 TikTok 的竖屏成片. An agent skill from binggandata/bggg-skills.

    605 GitHub stars~954 tokensUpdated 1 mo ago
    Auto-check passed

Works with

Questions about Bggg Tiktok Search

What does Bggg Tiktok Search do?

使用本地真实 Chrome 登录态做 TikTok 调研,支持 WebBridge、Chrome/CDP、Apple Events 或人工辅助路径。. Bggg Tiktok Search is an agent skill from binggandata/bggg-skills.

When should I use Bggg Tiktok Search?

Bggg Tiktok Search fits situations like: tasks that involve CSV and tabular files.

How do I install Bggg Tiktok Search in Claude Code?

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

How do I install Bggg Tiktok Search in Codex?

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

Can I use Bggg Tiktok 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 binggandata/bggg-skills --skill bggg-tiktok-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/bggg-tiktok-search, .gemini/skills/bggg-tiktok-search, .github/skills/bggg-tiktok-search and .opencode/skills/bggg-tiktok-search in your project.

What does Bggg Tiktok Search need to run?

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

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

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

About 1.5k tokens (SKILL.md is roughly 5.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.1k tokens, read only when the agent opens those files.

What are the alternatives to Bggg Tiktok Search?

Skills that share tags, products or a category with Bggg Tiktok Search: Overseas Trending Search (redfox-data/redfox-community, 427 stars), Data Table Manager (n8n-io/n8n, 207k stars), Instrument Data To Allotrope (aws-samples/amazon-bedrock-agents-healthcare-lifesciences, 274 stars) and Abuse Hunter (nexu-io/harness-engineering-guide, 664 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Bggg Tiktok Search?

binggandata (a GitHub user) maintains it in binggandata/bggg-skills, which has 605 GitHub stars. The repository holds 13 skills in this directory. The repository was last updated on August 13, 2026.

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