mcpField
T
tiktok-search

tiktok-search

github.com/gooseworks-aiProductivity1.3k38 installsUpdated 3d ago
Repository

About tiktok-search

A skill for finding TikTok profiles, videos, hashtag content, and trends, intended for social media research. It sends requests to the ScrapeCreators API through the GooseWorks proxy.

Key features

  1. 01Retrieve profile details and metrics
  2. 02Search videos by hashtag
  3. 03Fetch regional trending content
  4. 04Support pagination and trimmed responses

Use cases

  1. 01Review a TikTok account
  2. 02Find videos for a topic
  3. 03Research regional trends

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/gooseworks-ai/goose-skills --skill tiktok-search

After installing, type/tiktok-searchin Claude Code to confirm it loaded.

Bundled filesskill.meta.json

Details

From the project README

TikTok Search

Setup

Read scrapecreators-api first. Execute every operation below through the runtime it selects: the GooseWorks MCP tool in terminal-free clients, the GooseWorks CLI in a local terminal, or the direct API with the user's own key. Never assume a shell is available.

Search TikTok for profiles, videos, and hashtag content.

When to Use

  • User asks about a TikTok account
  • User wants to find TikTok videos
  • User asks about trending TikTok content
  • Social media research

How It Works

Uses the ScrapeCreators API through its direct GooseWorks proxy.

Usage

Get TikTok Profile
provider: scrapecreators
method: GET
path: /v1/tiktok/profile
query:
  handle: charlidamelio
Search Hashtag Videos
provider: scrapecreators
method: GET
path: /v1/tiktok/search/hashtag
query:
  hashtag: tech
Get Trending Feed
provider: scrapecreators
method: GET
path: /v1/tiktok/get-trending-feed
query:
  region: US

Parameters

Profile
  • handle (required) - TikTok handle (without @)
Hashtag Search
  • hashtag (required) - Hashtag to search (without #)
  • region (optional) - Region for the proxy
  • cursor (optional) - Cursor for pagination
  • trim (optional) - Set to "true" for a trimmed response
Trending Feed
  • region (required) - Region for the proxy (e.g., "US")
  • trim (optional) - Set to true for a trimmed response

Response

Profile includes:
  • Username and display name
  • Bio/description
  • Follower and following counts
  • Total likes
  • Verified status
  • Profile image
Videos include:
  • Video title/description
  • View count
  • Like count
  • Comment count
  • Video URL

Examples

User: "Look up charlidamelio on TikTok" Use the Get TikTok Profile operation with handle: charlidamelio.

User: "What's trending on TikTok?" Use the Get Trending Feed operation with the user's region, defaulting to US only when appropriate.

User: "What's trending with #tech on TikTok?" Use the Search Hashtag Videos operation with hashtag: tech.

Error Handling

  • success: false — the API may temporarily fail; retry after a few seconds
  • Private accounts cannot be accessed
  • Rate limiting may apply on rapid sequential requests

Tips

  • Remove @ from handles
  • Remove # from hashtags
  • Private accounts cannot be accessed

Comments

Markdown supported