tiktok-search について
TikTok のプロフィール、動画、ハッシュタグ投稿、トレンドを調べるスキルです。ソーシャルメディア調査などに向けて、GooseWorks のプロキシ経由で ScrapeCreators API を利用します。
主な機能
- 01プロフィール情報と指標の取得
- 02ハッシュタグ動画の検索
- 03地域別トレンドの取得
- 04ページネーションと応答の簡略化
活用シーン
- 01TikTok アカウントの確認
- 02特定テーマの動画検索
- 03地域トレンドの調査
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ gooseworks-ai/ goose-skills --skill tiktok-searchインストール後、Claude Code で/tiktok-searchを入力して読み込まれたか確認します。
同梱ファイルskill.meta.json
詳細
TikTok 検索
セットアップ
まず scrapecreators-api を読んでください。以下のすべての操作は、選択された実行環境を通じて行ってください。ターミナルを使わないクライアントでは GooseWorks MCP ツール、ローカルターミナルでは GooseWorks CLI、またはユーザー自身のキーを使った直接 API を使用します。シェルが利用できると決めつけないでください。
TikTok でプロフィール、動画、ハッシュタグのコンテンツを検索します。
使用する場面
- TikTok アカウントについてユーザーから質問されたとき
- ユーザーが TikTok の動画を探したいとき
- ユーザーからトレンドの TikTok コンテンツについて質問されたとき
- ソーシャルメディアの調査
仕組み
ScrapeCreators API を直接 GooseWorks プロキシ経由で使用します。
使用方法
TikTok プロフィールを取得
provider: scrapecreators
method: GET
path: /v1/tiktok/profile
query:
handle: charlidamelio
ハッシュタグ動画を検索
provider: scrapecreators
method: GET
path: /v1/tiktok/search/hashtag
query:
hashtag: tech
トレンドフィードを取得
provider: scrapecreators
method: GET
path: /v1/tiktok/get-trending-feed
query:
region: US
パラメーター
プロフィール
- handle(必須)- TikTok のハンドル(@なし)
ハッシュタグ検索
- hashtag(必須)- 検索するハッシュタグ(#なし)
- region(任意)- プロキシの地域
- cursor(任意)- ページネーション用カーソル
- trim(任意)- レスポンスを簡略化するには
"true"に設定します
トレンドフィード
- region(必須)- プロキシの地域(例:"US")
- trim(任意)- レスポンスを簡略化するには true に設定します
レスポンス
プロフィールに含まれる情報:
- ユーザー名と表示名
- 自己紹介/説明
- フォロワー数とフォロー中の数
- いいねの合計数
- 認証済みステータス
- プロフィール画像
動画に含まれる情報:
- 動画のタイトル/説明
- 再生回数
- いいね数
- コメント数
- 動画の URL
例
ユーザー:「TikTok で charlidamelio を調べて」
handle: charlidamelio を指定して、TikTok プロフィールを取得する操作を使用します。
ユーザー:「TikTok では何がトレンドなの?」
ユーザーの地域を指定して、トレンドフィードを取得する操作を使用します。適切な場合に限り、既定値として US を使用します。
ユーザー:「TikTok で #tech のトレンドは?」
hashtag: tech を指定して、ハッシュタグ動画を検索する操作を使用します。
エラー処理
- success: false — API が一時的に失敗している可能性があります。数秒後に再試行してください
- 非公開アカウントにはアクセスできません
- リクエストを短時間に連続して送ると、レート制限が適用される場合があります
ヒント
- ハンドルから @ を削除します
- ハッシュタグから # を削除します
- 非公開アカウントにはアクセスできません
コメント
Markdown 対応