mcpField
D
douyin-cli

douyin-cli

github.com/0xranxデータ・データベース093 回インストール32 週間前に更新
リポジトリ

douyin-cli について

douyin-cli は agent-browser を通じて抖音の Web データを取得するコマンドラインスキルです。公式 API キーを使わず、検索、動画やクリエイターの確認、結果のエクスポートを行うワークフローに対応します。

主な機能

  1. 01動画とユーザーの検索
  2. 02動画詳細とコメントの表示
  3. 03ユーザープロフィールと投稿の取得
  4. 04スクロールによる追加結果の読み込み
  5. 05JSON または CSV へのエクスポート

活用シーン

  1. 01抖音動画を検索して詳細を確認
  2. 02クリエイターのプロフィールと投稿を確認
  3. 03コメントを集めて検索結果をエクスポート

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/0xranx/agent-kit --skill douyin-cli

インストール後、Claude Code で/douyin-cliを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

.gitignore
douyin_sign.py
douyin.py
requirements.txt

詳細

プロジェクトの README より

抖音 CLI

通过 agent-browser 实现抖音 Web 数据提取，无需官方 API Key。

前置条件

  1. 安装 agent-browser：npm install -g agent-browser && agent-browser install
  2. 登录抖音（二选一）：
    • 推荐：在 Chrome 中登录抖音，然后用 --auto-connect 模式
    • 或：python douyin.py login（启动独立浏览器登录）

验证登录状态：

python skills/douyin-cli/douyin.py status

触发条件

以下情况使用此 Skill：

  • 用户要搜索抖音内容
  • 用户要查看某个抖音视频的详情或评论
  • 用户要了解某个抖音创作者的主页和作品
  • 用户发送了 douyin.com 链接

搜索

python skills/douyin-cli/douyin.py search "关键词"                       # 搜索视频
python skills/douyin-cli/douyin.py search "关键词" --user                 # 搜索用户
python skills/douyin-cli/douyin.py search "关键词" --auto-connect         # 用 Chrome（推荐）

视频详情和评论

python skills/douyin-cli/douyin.py detail <aweme_id>         # 视频详情
python skills/douyin-cli/douyin.py comments <aweme_id>       # 评论列表
python skills/douyin-cli/douyin.py video <aweme_id>          # 详情 + 评论

aweme_id 从搜索结果或视频 URL 中获取（/video/ 后面的数字）。

用户信息

python skills/douyin-cli/douyin.py user <sec_user_id>        # 用户主页
python skills/douyin-cli/douyin.py posts <sec_user_id>       # 用户作品列表

sec_user_id 从用户主页 URL 中获取（/user/ 后面的字符串）。

翻页和导出

python skills/douyin-cli/douyin.py more [次数]               # 滚动加载更多（默认3次）
python skills/douyin-cli/douyin.py export results.json        # 导出为 JSON
python skills/douyin-cli/douyin.py export results.csv --csv   # 导出为 CSV

export 导出上次 search/posts 命令的结果。

两种运行模式

auto-connect 模式（推荐）

连接用户已登录的 Chrome，绕过验证码：

python douyin.py search "关键词" --auto-connect

前提：Chrome 已打开且已登录抖音。所有命令都支持 --auto-connect 选项。

profile 模式（默认）

使用独立浏览器 + 持久化 profile：

python douyin.py login              # 首次登录
python douyin.py search "关键词"     # 后续使用

典型工作流

「帮我搜一下抖音上关于 XX 的视频」
  1. search "XX" 搜索
  2. 对感兴趣的视频 video <id> 查看详情+评论
  3. 总结返回
「帮我看看这个抖音博主」
  1. user <sec_user_id> 获取主页
  2. posts <sec_user_id> 查看作品列表
「把搜索结果导出给我」
  1. search "关键词" 搜索
  2. more 5 加载更多
  3. export results.csv --csv 导出

注意事项

  • 抖音反爬较严，高频请求可能触发验证码
  • auto-connect 模式连接用户真实 Chrome，验证码概率最低
  • profile 模式首次使用必须 login
  • 评论需要页面滚动触发加载，首次可能获取不全
  • 搜索间隔建议 5 秒以上

コメント

Markdown 対応