# Douyin Explore

> 在抖音网页版按关键词搜索公开作品，并读取 video 或 note 作品详情。用户要求搜索抖音、查找作品、查看公开作品详情或解析抖音作品链接时使用。

- **Type:** Skill
- **Install:** `agentstack add skill-zjay26-douyin-skills-douyin-explore`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [zJay26](https://agentstack.voostack.com/s/zjay26)
- **Installs:** 0
- **Category:** [Web & Browser](https://agentstack.voostack.com/c/web-and-browser)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [zJay26](https://github.com/zJay26)
- **Source:** https://github.com/zJay26/douyin-skills/tree/main/skills/douyin-explore

## Install

```sh
agentstack add skill-zjay26-douyin-skills-douyin-explore
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 搜索与查看公开作品

只使用 `python "{baseDir}/../../scripts/cli.py" `。如果系统只有 `python3`，替换命令名。

## 前置条件

1. 根据用户指定账号传 `--account `；未指定时使用 CLI 默认账号。
2. 先运行 `check-login`。未登录时转交 `douyin-auth`。
3. 检测到 `needs_user_verification` 后停下，请用户在 headed 浏览器处理验证。

## 搜索

```bash
python "{baseDir}/../../scripts/cli.py" search-videos --keyword "关键词" --limit 7
```

- 默认返回 7 条，用户明确指定时调整，单次最多 20 条。
- 关键词为空时停止并请用户补充。
- 结果同时可能包含 `video` 与 `note`，以每项 `kind` 字段为准。
- 用标题、作者、作品类型和公开链接整理结果；缺失字段保持为空，不推测作者 ID 或互动数据。

## 读取详情

`--video-id` 兼容纯数字 ID、`douyin.com/video/...` 与 `douyin.com/note/...` 公开链接：

```bash
python "{baseDir}/../../scripts/cli.py" get-video-detail --video-id 
```

拒绝非 `douyin.com` 链接。根据 `content_type` 区分视频和图文；作品不存在、私密、已删除或页面结构变化时如实报告。

## 结果与边界

- `success: false` 且 `risk_page: true`：切到人工验证流程。
- `count: 0` 且 `success: true`：搜索正常但没有结果，可建议更换关键词。
- 不执行用户主页批量抓取、评论区全量采集、高级筛选、热点榜单或数据分析。
- 不为补齐作者 ID 逐条打开结果详情；保持搜索流程轻量，避免额外请求。

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [zJay26](https://github.com/zJay26)
- **Source:** [zJay26/douyin-skills](https://github.com/zJay26/douyin-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-zjay26-douyin-skills-douyin-explore
- Seller: https://agentstack.voostack.com/s/zjay26
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.