dy-cli 0.2.0__py3-none-any.whl

dy_cli-0.2.0.dist-info/METADATA

@@ -0,0 +1,376 @@
+Metadata-Version: 2.4
+Name: dy-cli
+Version: 0.2.0
+Summary: 抖音命令行工具 — 发布、搜索、下载、互动、数据分析、热榜、直播
+Project-URL: Homepage, https://github.com/Youhai020616/douyin
+Project-URL: Repository, https://github.com/Youhai020616/douyin
+Project-URL: Issues, https://github.com/Youhai020616/douyin/issues
+Author-email: Youhai <youhai020616@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: automation,cli,douyin,dy,tiktok,抖音
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Requires-Dist: browser-cookie3>=0.19
+Requires-Dist: click>=8.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: playwright>=1.40
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.0
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <h1 align="center">🎬 douyin</h1>
+  <p align="center">AI-powered Douyin (抖音/TikTok China) automation — search, download, publish, engage, and analyze.</p>
+</p>
+
+<p align="center">
+  <a href="#cli-quick-start">CLI Quick Start</a> •
+  <a href="#features">Features</a> •
+  <a href="#commands">Commands</a> •
+  <a href="#scripts">Scripts</a> •
+  <a href="#claude-code-integration">Claude Code</a> •
+  <a href="./LICENSE">License</a>
+</p>
+
+---
+
+<p align="center">
+  <img src="./demo.gif" alt="dy-cli demo" width="800">
+</p>
+
+## CLI Quick Start
+
+The fastest way to get started — **3 commands** from zero to searching:
+
+```bash
+# 1. Clone
+git clone https://github.com/your-username/douyin.git
+cd douyin
+
+# 2. One-click install (auto: Python check → venv → pip install → Playwright Chromium)
+bash setup.sh
+
+# 3. Initialize (auto: install Chromium → config → QR login)
+source activate.sh && dy init
+```
+
+Then just use:
+
+```bash
+dy search "AI创业"                                            # Search
+dy trending                                                    # Hot trending
+dy download https://v.douyin.com/xxxxx/                        # Download (no watermark)
+dy publish -t "Hello" -c "My first post" -v video.mp4         # Publish
+dy live info ROOM_ID                                           # Live stream info
+dy analytics                                                   # Dashboard
+dy --help                                                      # All commands
+```
+
+> 📖 Full CLI guide: [docs/cli-guide.md](docs/cli-guide.md)
+
+---
+
+## What is this?
+
+A complete toolkit for automating Douyin (抖音/TikTok China) operations through two complementary engines:
+
+| Engine | Technology | Use Cases | Startup |
+|--------|-----------|-----------|---------|
+| **API Client** | Python httpx, reverse-engineered API | Search, download, comments, trending, live | Instant |
+| **Playwright** | Python Playwright, browser automation | Publish, login, analytics dashboard | On-demand |
+
+Built as an [OpenClaw](https://github.com/openclaw/openclaw) Skill, but works standalone or with any MCP-compatible client (Claude Code, Cursor, etc.).
+
+## Features
+
+- 🔍 **Search** — Keyword search with filters (sort, time, type)
+- 📥 **Download** — No-watermark video/image download with progress bar
+- 📝 **Publish** — Video and image posts with tags, scheduling, visibility
+- 🔥 **Trending** — Real-time hot search rankings with watch mode
+- 📺 **Live** — Live stream info, stream URL extraction, ffmpeg recording
+- 💬 **Engage** — Comment, like, favorite, follow
+- 📊 **Analytics** — Creator dashboard data export (CSV)
+- 🔔 **Notifications** — Fetch interaction notifications
+- 👤 **Profile** — Fetch any user's profile and posts
+- 👥 **Multi-Account** — Isolated cookie storage per account
+- 🔐 **QR Code Login** — Scan-to-login via Playwright, persistent cookie storage
+
+## Quick Start
+
+### Prerequisites
+
+- Python 3.10+
+- Playwright Chromium (auto-installed by `setup.sh`)
+- ffmpeg (optional, for live recording: `brew install ffmpeg`)
+
+### 1. Clone & Install
+
+```bash
+git clone https://github.com/your-username/douyin.git
+cd douyin
+bash setup.sh
+```
+
+### 2. Initialize & Login
+
+```bash
+source activate.sh
+dy init
+```
+
+This will:
+1. Check your environment
+2. Install Playwright Chromium
+3. Configure proxy (optional)
+4. Open browser for QR code login
+
+### 3. Start Using
+
+```bash
+dy search "旅行"           # Search
+dy trending                 # Hot topics
+dy download URL             # Download video
+```
+
+---
+
+## Commands
+
+### Search & Discovery
+
+```bash
+dy search "关键词"                          # Basic search
+dy search "咖啡" --sort 最多点赞            # Sort by likes
+dy search "春招" --time 一天内 --type video  # Filters
+dy trending                                  # Hot trending list
+dy trending --watch                          # Auto-refresh every 5 min
+dy trending --json-output                    # JSON output
+```
+
+### Download
+
+```bash
+dy download https://v.douyin.com/xxxxx/      # Share link
+dy download https://www.douyin.com/video/123  # Full link
+dy download 1234567890                        # Video ID
+dy download URL --music                       # Also download BGM
+dy download URL -o ~/Videos                   # Custom output dir
+```
+
+### Publish
+
+```bash
+# Video
+dy publish -t "标题" -c "描述" -v video.mp4
+
+# Image post
+dy publish -t "标题" -c "描述" -i img1.jpg -i img2.jpg
+
+# With tags
+dy publish -t "旅行日记" -c "巴厘岛" -v trip.mp4 --tags 旅行 --tags 巴厘岛
+
+# Private (test)
+dy publish -t "测试" -c "测试" -v test.mp4 --visibility 仅自己可见
+
+# Scheduled
+dy publish -t "早安" -c "新的一天" -v morning.mp4 --schedule "2026-03-16T08:00:00+08:00"
+
+# Preview only
+dy publish -t "标题" -c "描述" -v video.mp4 --dry-run
+```
+
+### Video Detail & Comments
+
+```bash
+dy detail AWEME_ID                          # Video detail
+dy detail AWEME_ID --comments               # With comments
+dy comments AWEME_ID                        # Comments only
+```
+
+### Interaction
+
+```bash
+dy like AWEME_ID                            # Like
+dy favorite AWEME_ID                        # Favorite
+dy comment AWEME_ID -c "Great!"             # Comment
+dy follow SEC_USER_ID                       # Follow user
+```
+
+### Live Stream
+
+```bash
+dy live info ROOM_ID                        # Live info + stream URLs
+dy live record ROOM_ID                      # Record with ffmpeg
+dy live record ROOM_ID --quality HD1        # Specific quality
+```
+
+### Analytics & Notifications
+
+```bash
+dy analytics                                # Creator dashboard
+dy analytics --csv data.csv                 # Export CSV
+dy notifications                            # Messages
+```
+
+### User Profile
+
+```bash
+dy me                                       # My info
+dy profile SEC_USER_ID                      # User profile
+dy profile SEC_USER_ID --posts              # With post list
+```
+
+### Multi-Account
+
+```bash
+dy account list                             # List accounts
+dy account add work                         # Add & login
+dy account default work                     # Set default
+dy account remove work                      # Remove
+```
+
+### Configuration
+
+```bash
+dy config show                              # Show config
+dy config set api.proxy http://127.0.0.1:7897
+dy config set default.download_dir ~/Videos
+dy config reset                             # Reset to defaults
+```
+
+### Command Aliases
+
+| Alias | Full Command |
+|-------|-------------|
+| `dy pub` | `dy publish` |
+| `dy s` | `dy search` |
+| `dy dl` | `dy download` |
+| `dy t` | `dy trending` |
+| `dy fav` | `dy favorite` |
+| `dy noti` | `dy notifications` |
+| `dy stat` | `dy status` |
+| `dy acc` | `dy account` |
+| `dy cfg` | `dy config` |
+
+---
+
+## Engine Architecture
+
+| Engine | Features | Technology |
+|--------|----------|------------|
+| **API Client** | Search, download, comments, trending, live, user profile | httpx + reverse-engineered API |
+| **Playwright** | Publish, login, analytics, notifications | Playwright browser automation |
+
+Most commands auto-select the best engine. Only `publish`, `analytics`, and `login` require Playwright.
+
+---
+
+## Scripts
+
+Standalone Python scripts for direct use without the CLI:
+
+```bash
+# Login
+python scripts/douyin_login.py --account default
+
+# Publish video
+python scripts/douyin_publisher.py -t "标题" -c "描述" -v video.mp4
+
+# Publish images
+python scripts/douyin_publisher.py -t "标题" -c "描述" -i img1.jpg img2.jpg
+
+# Analytics
+python scripts/douyin_analytics.py --csv output.csv
+
+# Chrome management
+python scripts/chrome_launcher.py
+python scripts/chrome_launcher.py --kill
+```
+
+---
+
+## Claude Code Integration
+
+See [docs/claude-code-integration.md](docs/claude-code-integration.md) for setup instructions.
+
+## Project Structure
+
+```
+douyin/
+├── README.md                          # This file
+├── SKILL.md                           # OpenClaw skill definition
+├── pyproject.toml                     # CLI package config
+├── manifest.json                      # Skill metadata
+├── LICENSE                            # MIT License
+├── requirements.txt                   # Python dependencies
+├── setup.sh                           # One-click install (macOS/Linux)
+├── setup.bat                          # One-click install (Windows)
+├── activate.sh                        # Environment activation
+├── src/dy_cli/                        # ⭐ CLI package
+│   ├── main.py                        # Unified entry point (dy command)
+│   ├── engines/
+│   │   ├── api_client.py              # Reverse-engineered API client
+│   │   └── playwright_client.py       # Playwright browser automation
+│   ├── commands/
+│   │   ├── init.py                    # dy init (guided setup)
+│   │   ├── auth.py                    # dy login/logout/status
+│   │   ├── publish.py                 # dy publish (Playwright)
+│   │   ├── search.py                  # dy search/detail (API)
+│   │   ├── download.py                # dy download (API) ⭐
+│   │   ├── interact.py                # dy like/comment/favorite/follow
+│   │   ├── trending.py                # dy trending (API) ⭐
+│   │   ├── live.py                    # dy live info/record ⭐
+│   │   ├── analytics.py               # dy analytics (Playwright)
+│   │   ├── profile.py                 # dy me/profile
+│   │   ├── account.py                 # dy account management
+│   │   └── config_cmd.py              # dy config
+│   └── utils/
+│       ├── config.py                  # ~/.dy/config.json management
+│       ├── output.py                  # Rich formatted output
+│       └── signature.py               # Douyin signature utilities
+├── scripts/
+│   ├── douyin_login.py                # Login script
+│   ├── douyin_publisher.py            # Publish script
+│   ├── douyin_analytics.py            # Analytics script
+│   └── chrome_launcher.py             # Chrome lifecycle
+├── config/
+│   └── accounts.json.example
+└── docs/
+    ├── cli-guide.md                   # CLI usage guide
+    └── claude-code-integration.md     # Claude Code setup
+```
+
+## Platform Support
+
+| Component | macOS | Linux | Windows |
+|-----------|:-----:|:-----:|:-------:|
+| **dy CLI** | ✅ | ✅ | ✅ |
+| API Client | ✅ | ✅ | ✅ |
+| Playwright | ✅ | ✅ | ✅ |
+
+## Tips & Known Issues
+
+- **Signature algorithm**: Douyin frequently updates `a-bogus`/`x-bogus` — some API calls may need browser-based signing
+- **Login**: Cookie expires periodically, re-login with `dy login`
+- **Rate limiting**: Avoid rapid-fire requests, add delays between batch operations
+- **Proxy**: Outside China may need proxy: `dy config set api.proxy http://...`
+- **Live recording**: Requires ffmpeg: `brew install ffmpeg` (macOS)
+
+## Contributing
+
+Issues and PRs welcome! Areas where help is needed:
+
+- [ ] Improved `a-bogus` signature algorithm
+- [ ] Batch download by user/hashtag
+- [ ] Playwright interaction (like/comment/follow)
+- [ ] More analytics data points
+- [ ] Test suite
+
+## License
+
+[MIT](./LICENSE)

dy_cli-0.2.0.dist-info/RECORD

@@ -0,0 +1,34 @@
+scripts/chrome_launcher.py,sha256=wOsxSyoFx4XtFe7ZHK3O0RY9xlbf5U5OrbjYf4YaZhI,2269
+scripts/douyin_analytics.py,sha256=iIom8IeHOz9KhZMOMWr4C1aOzeR4191XHt7Vb8jqrEw,3450
+scripts/douyin_login.py,sha256=UTwK4-YiOCX6pXIck49PV9I6hTZv84Dy6G9evaDgeRI,1933
+scripts/douyin_publisher.py,sha256=Ny2CVGxJnPcJ04dZWia_Mi5nuVDotTwHtMHOSmZYAWE,7033
+dy_cli/__init__.py,sha256=KmtSQreEp4d8uycTz7chUSNz0tyEO6N0YRc94R6NAoU,65
+dy_cli/main.py,sha256=sKXUUW_P_Kw4juTO7_019J-yACgtWVSFCdcgg7wFtHc,4212
+dy_cli/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+dy_cli/commands/account.py,sha256=Ahud5A2AaVkQ8NYoFSMEAeZWzzKP9uWAVnkj4zvMM54,3199
+dy_cli/commands/analytics.py,sha256=HTrJHi7BfM9aHgq_kPzci3samFCZmAyh3XQEbLJT58g,3568
+dy_cli/commands/auth.py,sha256=PGU43AC50wv6jOW9FGeFe149o8yNp2Tdv2NLaVxFj7U,5417
+dy_cli/commands/config_cmd.py,sha256=5JFuUBCl4_8YAn7io85K6eFHSIOxEjy_Dl2YbbVgwDk,1752
+dy_cli/commands/download.py,sha256=XMOt5KXHmZOeb0wloLVDIS6WEhqLjhWI1AtOy8b7fRU,7683
+dy_cli/commands/init.py,sha256=SxVmG36TJ1fyhY1MHzEz1a4r96ffJ7Fsbpsj8_GgicQ,7555
+dy_cli/commands/interact.py,sha256=X6I6wVlnvkeZ1EQ1zhyac-q2CjfrHZWR_ZAndTcpBk0,4881
+dy_cli/commands/live.py,sha256=xbtF4A6Qg39YpNVhXP414NgH-G41K8d3RIkvKTNYbgk,4726
+dy_cli/commands/profile.py,sha256=1cwgrYGBeF5iJRRceyzGkPZ568QTzox7ZROxGkAAmeg,2650
+dy_cli/commands/publish.py,sha256=1UyxsTei4pROsaOP2hmgfbDb7Fucld2eiHwL18weEU4,4635
+dy_cli/commands/search.py,sha256=UEzU1lgwm5i8cT4-N7CXgvxZShJtC6-nhNNUmgacDqk,4275
+dy_cli/commands/trending.py,sha256=iUOs0JKffsXv4xcmA2Bxgp37HcXPEy4SpwcmuOVcDm4,2714
+dy_cli/engines/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+dy_cli/engines/api_client.py,sha256=AksJ-4jL_qYaUP5SyQWW3cLleDVccIOz41x81Ze4xO8,23211
+dy_cli/engines/playwright_client.py,sha256=-p3DW_y1wXn0JxrHc2L-jgCwdRL_WmYRMofztofsw0Q,35198
+dy_cli/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+dy_cli/utils/config.py,sha256=S73PvZvMWGZPJf3VYV3MnK-HwMXBMFWemRz7gU71BRA,2781
+dy_cli/utils/envelope.py,sha256=cJj9LPhCwSfPr-Jxkvrktk02SSL3SOL898cSQCCidmA,1434
+dy_cli/utils/export.py,sha256=I3aG7Li5y1K3MwZKmhdzUS09THRk-IFlnnGEwWJ0rDI,2034
+dy_cli/utils/index_cache.py,sha256=o1uObcXCE1QHCeZ6Odfl4ch9GEfMt53rud4bVzM27uc,2815
+dy_cli/utils/output.py,sha256=loqW4dc9JvEBWuLZBzabOSxK3yM2u2b46Y4H0fec3Pc,9715
+dy_cli/utils/signature.py,sha256=LM4V_tieB-lHo5zmpIRlHKDBqcf_yS2_16OT1OR6nKo,5870
+dy_cli-0.2.0.dist-info/METADATA,sha256=b-L_5nOb8FLJYocUlMm8r6OCvGfFA-UxTnVN7xk3eGk,12358
+dy_cli-0.2.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+dy_cli-0.2.0.dist-info/entry_points.txt,sha256=FV1C9hRIdlkSnnNwvU515738x5AJxaFxFxFduCcjbAM,39
+dy_cli-0.2.0.dist-info/licenses/LICENSE,sha256=ESYyLizI0WWtxMeS7rGVcX3ivMezm-HOd5WdeOh-9oU,1056
+dy_cli-0.2.0.dist-info/RECORD,,

dy_cli-0.2.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

dy_cli-0.2.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+dy = dy_cli.main:cli

dy_cli-0.2.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

scripts/chrome_launcher.py

@@ -0,0 +1,71 @@
+"""
+Chrome/Chromium 生命周期管理。
+
+Usage:
+    python scripts/chrome_launcher.py               # 启动 (Playwright Chromium)
+    python scripts/chrome_launcher.py --headless     # 无头模式
+    python scripts/chrome_launcher.py --kill         # 关闭
+"""
+from __future__ import annotations
+
+import argparse
+import asyncio
+import os
+import signal
+import subprocess
+import sys
+
+
+async def launch_chromium(headless: bool = False):
+    """使用 Playwright 启动 Chromium。"""
+    from playwright.async_api import async_playwright
+
+    async with async_playwright() as pw:
+        browser = await pw.chromium.launch(headless=headless)
+        context = await browser.new_context()
+        page = await context.new_page()
+        await page.goto("https://www.douyin.com/", wait_until="domcontentloaded")
+
+        endpoint = browser._impl_obj._browser.ws_endpoint if hasattr(browser._impl_obj, '_browser') else "N/A"
+        print(f"[dy] Chromium 已启动")
+        print(f"[dy] Headless: {headless}")
+        print(f"[dy] 按 Ctrl+C 关闭")
+
+        try:
+            while True:
+                await asyncio.sleep(1)
+        except (KeyboardInterrupt, asyncio.CancelledError):
+            pass
+        finally:
+            await browser.close()
+            print("[dy] Chromium 已关闭")
+
+
+def kill_chromium():
+    """关闭所有 Playwright Chromium 进程。"""
+    try:
+        if sys.platform == "darwin":
+            subprocess.run(["pkill", "-f", "chromium"], capture_output=True)
+        elif sys.platform == "win32":
+            subprocess.run(["taskkill", "/F", "/IM", "chromium.exe"], capture_output=True)
+        else:
+            subprocess.run(["pkill", "-f", "chromium"], capture_output=True)
+        print("[dy] Chromium 进程已终止")
+    except Exception as e:
+        print(f"[dy] 关闭失败: {e}")
+
+
+def main():
+    parser = argparse.ArgumentParser(description="Chrome/Chromium 管理")
+    parser.add_argument("--headless", action="store_true", help="无头模式")
+    parser.add_argument("--kill", action="store_true", help="关闭 Chromium")
+    args = parser.parse_args()
+
+    if args.kill:
+        kill_chromium()
+    else:
+        asyncio.run(launch_chromium(headless=args.headless))
+
+
+if __name__ == "__main__":
+    main()

scripts/douyin_analytics.py

@@ -0,0 +1,99 @@
+"""
+抖音数据看板脚本 — Playwright 爬取 creator.douyin.com 数据。
+
+Usage:
+    python scripts/douyin_analytics.py
+    python scripts/douyin_analytics.py --csv output.csv
+    python scripts/douyin_analytics.py --account work
+"""
+from __future__ import annotations
+
+import argparse
+import asyncio
+import csv
+import json
+import os
+import sys
+
+
+async def get_analytics(account: str = "default", csv_file: str | None = None):
+    """获取创作者数据看板。"""
+    from playwright.async_api import async_playwright
+
+    cookie_file = os.path.expanduser(f"~/.dy/cookies/{account}.json")
+    if not os.path.isfile(cookie_file):
+        print(f"[dy] Cookie 文件不存在: {cookie_file}")
+        return None
+
+    async with async_playwright() as pw:
+        browser = await pw.chromium.launch(headless=True)
+        context = await browser.new_context(storage_state=cookie_file)
+        page = await context.new_page()
+
+        try:
+            print("[dy] 正在访问数据看板...")
+            await page.goto(
+                "https://creator.douyin.com/creator-micro/data/stats/self-content",
+                wait_until="domcontentloaded",
+            )
+            await page.wait_for_timeout(5000)
+
+            if await page.get_by_text("扫码登录").count() > 0:
+                print("[dy] Cookie 已失效")
+                return None
+
+            # Extract data
+            data = await page.evaluate("""() => {
+                const rows = [];
+                const items = document.querySelectorAll('tr, [class*="content-item"]');
+                items.forEach(item => {
+                    const cells = item.querySelectorAll('td, [class*="cell"]');
+                    if (cells.length >= 3) {
+                        const texts = Array.from(cells).map(c => c.textContent.trim());
+                        rows.push({
+                            '标题': texts[0] || '-',
+                            '发布时间': texts[1] || '-',
+                            '播放': texts[2] || '-',
+                            '完播率': texts[3] || '-',
+                            '点赞': texts[4] || '-',
+                            '评论': texts[5] || '-',
+                            '分享': texts[6] || '-',
+                            '涨粉': texts[7] || '-',
+                        });
+                    }
+                });
+                return rows;
+            }""")
+
+            print(f"[dy] 获取到 {len(data)} 条数据")
+
+            # Output JSON
+            print(json.dumps(data, ensure_ascii=False, indent=2))
+
+            # Export CSV
+            if csv_file and data:
+                keys = data[0].keys()
+                with open(csv_file, "w", newline="", encoding="utf-8-sig") as f:
+                    writer = csv.DictWriter(f, fieldnames=keys)
+                    writer.writeheader()
+                    writer.writerows(data)
+                print(f"[dy] CSV 已导出: {csv_file}")
+
+            return data
+
+        finally:
+            await browser.close()
+
+
+def main():
+    parser = argparse.ArgumentParser(description="抖音数据看板")
+    parser.add_argument("--account", default="default", help="账号名")
+    parser.add_argument("--csv", default=None, help="导出 CSV 文件路径")
+    args = parser.parse_args()
+
+    result = asyncio.run(get_analytics(args.account, args.csv))
+    sys.exit(0 if result is not None else 1)
+
+
+if __name__ == "__main__":
+    main()

scripts/douyin_login.py

@@ -0,0 +1,64 @@
+"""
+抖音登录脚本 — Playwright 扫码登录，保存 Cookie。
+
+Usage:
+    python scripts/douyin_login.py
+    python scripts/douyin_login.py --account work
+"""
+from __future__ import annotations
+
+import argparse
+import asyncio
+import os
+import sys
+
+
+async def login(account: str = "default"):
+    """打开浏览器扫码登录抖音。"""
+    from playwright.async_api import async_playwright
+
+    # Cookie save path
+    cookie_dir = os.path.expanduser("~/.dy/cookies")
+    os.makedirs(cookie_dir, exist_ok=True)
+    cookie_file = os.path.join(cookie_dir, f"{account}.json")
+
+    async with async_playwright() as pw:
+        browser = await pw.chromium.launch(headless=False)
+        context = await browser.new_context()
+        page = await context.new_page()
+
+        print("[dy] 正在打开抖音创作者中心...")
+        await page.goto("https://creator.douyin.com/", wait_until="domcontentloaded")
+
+        print("[dy] 请使用抖音 App 扫码登录")
+        print("[dy] 扫码后浏览器会自动关闭")
+
+        # Wait for login — detect navigation to creator dashboard
+        try:
+            await page.wait_for_url("**/creator-micro/**", timeout=120000)
+            await page.wait_for_timeout(3000)
+            print("[dy] 登录成功!")
+        except Exception:
+            print("[dy] 登录超时")
+            await browser.close()
+            return False
+
+        # Save cookies (playwright storage_state format)
+        await context.storage_state(path=cookie_file)
+        print(f"[dy] Cookie 已保存: {cookie_file}")
+
+        await browser.close()
+        return True
+
+
+def main():
+    parser = argparse.ArgumentParser(description="抖音扫码登录")
+    parser.add_argument("--account", default="default", help="账号名 (默认: default)")
+    args = parser.parse_args()
+
+    ok = asyncio.run(login(args.account))
+    sys.exit(0 if ok else 1)
+
+
+if __name__ == "__main__":
+    main()