OpenParable
Skip to content
← Back to skills

Douyin

Apps & Automation
douyin

Douyin is an Agent Skill for apps & automation published in the sigcli/sigcli repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Provide authenticated cookies for Douyin (抖音/TikTok China) — two providers: douyin (www.douyin.com for scraping) and douyin-live (live.douyin.com for livestream). Use this skill whenever the user needs Douyin cookies for scraping tools like DouYin_Spider, or needs to authenticate with Douyin services. Trigger when the user mentions 抖音, Douyin, TikTok China, douyin cookies, or wants to use tools that require Douyin login cookies.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/sigcli/sigcli/blob/HEAD/skills/douyin/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/douyin, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Douyin Skill (Cookie Provider)

This skill provides authenticated cookies for Douyin (抖音) via sigcli. It produces two sets of cookies for different domains:

ProviderDomainUse case
douyinwww.douyin.comData scraping (videos, users, search, comments)
douyin-livelive.douyin.comLivestream monitoring (弹幕, gifts, WebSocket)

Setup

1. Configure providers

Add the config from references/provider-config.yaml to ~/.sig/config.yaml under providers:.

2. Login

sig login douyin        # Opens browser, scan QR code with Douyin app
sig login douyin-live   # Same — captures live.douyin.com cookies

3. Verify

sig status douyin
sig status douyin-live
# Both should show: valid: true

Usage with DouYin_Spider

Once cookies are obtained, use DouYin_Spider for data scraping and livestream monitoring:

# Install DouYin_Spider
git clone https://github.com/cv-cat/DouYin_Spider.git
cd DouYin_Spider
pip install -r requirements.txt && npm install

# Write cookies to .env
echo "DY_COOKIES='$(sig get douyin --no-redaction --format value)'" > .env
echo "DY_LIVE_COOKIES='$(sig get douyin-live --no-redaction --format value)'" >> .env

# Run
python main.py              # Data scraping
python dy_live/server.py    # Livestream monitoring
python dy_apis/douyin_recv_msg.py  # Private message receiving

Get cookies

# www.douyin.com cookie (for scraping)
sig get douyin --no-redaction --format value

# live.douyin.com cookie (for livestream)
sig get douyin-live --no-redaction --format value

Validation

The validateRule uses Douyin's notification count API:

  • Endpoint: https://www.douyin.com/aweme/v1/web/notice/count/
  • Logged in: {"status_code": 0, "notice_count": [...]}
  • Not logged in: {"status_code": 8, "status_msg": "用户未登录"}
  • Rule: res.body.status_code === 0

Notes

  • Douyin requires visible browser login (QR code scan) — loginMode: visible
  • Cookies from .douyin.com parent domain are shared between www and live subdomains
  • TTL is set to 2h; use sig watch add douyin for auto-refresh