抖音评论导出 · 抖评岛

粘贴抖音链接，导出评论和回复为 CSV 或 Excel，也可先看样本

把用户提供的公开抖音视频链接或分享文案交给抖评岛（ExportDou），导出评论供用户下载或分析。只处理公开可访问的视频，不索要抖音 Cookie 或抖音账号登录状态。

需要 Node.js 18.17 及以上版本和 npx。下面的命令固定使用已发布的 exportdou@1.0.3，默认 API 为 https://api.exportdou.cn/v1。若用户明确配置了 EXPORTDOU_API_URL，尊重该设置。用用户的语言解释结果，命令、任务 ID 和错误码保持原样。

先确认账号

本次会话第一次操作前检查登录状态：

bash

npx exportdou@1.0.3 whoami --json

未登录时运行：

bash

npx exportdou@1.0.3 login --json

把 CLI 打印的授权地址交给用户，在抖评岛网页完成确认。登录命令会等待授权，应保留这次进程并读取后续输出，不要反复启动登录。授权成功后 CLI 会保存凭证。用户主动通过安全环境变量提供 API Key 时，可使用 EXPORTDOU_API_KEY；不要让用户把 Key 发到对话中，也不要输出 Key。

确认要导出哪些评论

• 用户指定数量，就按该数量导出；只想先看样本或做初步分析时，默认取 100 条。
• 正式导出但没有说明数量，也没有要求全部时，先问需要多少条。
• 默认导出一级评论；用户需要楼中楼回复时再加 --replies。一级评论和回复共用一个总行数上限。
• “全部一级评论”：先查看视频信息，再使用 --all。CLI 会检查公开评论数、20 万条上限和可用积分。
• --all 不能和 --replies 一起使用。 公开计数不能覆盖每条回复。需要“全部评论和回复”时，说明这一限制，让用户确定总行数，再用 --limit N --replies，不要承诺一定采全。
• 默认 CSV；用户要求 Excel 时使用 --format xlsx。回复和 Excel 功能可能需要对应套餐，以服务返回的权限为准。

查看视频信息、公开评论数和少量样本：

bash

npx exportdou@1.0.3 inspect "<抖音链接或分享文案>" --json

提交一次，保存任务 ID

下面的 1000 是示例，实际使用用户确定的数量：

bash

EXPORTDOU_CLIENT_NAME=exportdou-skill npx exportdou@1.0.3 export "<抖音链接或分享文案>" --limit 1000 --json

若需要回复和 Excel，在同一条创建命令里加上 --replies --format xlsx。--limit 允许 1 至 200000；不要同时传 --all 和 --limit。

保存输出中的 taskId。创建命令立即返回，任务在云端继续执行。不要重复提交原链接来查询进度。 CLI 在安全重试时会复用同一个请求标识，并尝试找回网络中断时已受理的任务。若仍未拿到任务 ID，先查历史记录，不要套重试循环重新创建。

等待返回的建议间隔后，用同一个 ID 查进度：

bash

npx exportdou@1.0.3 status "<task-id>" --json

queued、processing、rendering 表示仍在进行；按 retryAfterSeconds 再查。completed、partial、failed、cancelled 表示本轮已结束，停止轮询。默认不要加 --wait；只有用户明确希望终端持续等待时才使用它。

只导出了一部分怎么办

partial 表示已有文件可用，但采集没有完成。先说明实际导出了多少，以及未完成的原因。用户仍需要余下结果时，继续原任务：

bash

npx exportdou@1.0.3 resume "<task-id>" --json

此命令从保存的断点继续，仅预留剩余行数所需积分。之后仍用同一个任务 ID 查进度。如果断点已过期或任务不允许继续，说明原因，保留已有结果；不要擅自重建一个收费任务。

查看样本、下载文件

用户要分析时，先取少量结构化评论：

bash

npx exportdou@1.0.3 preview "<task-id>" --limit 20 --json

每次最多预览 50 条。分析时说明样本数量和范围，不要把小样本结论说成全部评论的结论，也不要把整个大型导出文件塞进对话上下文。

下载完整文件：

bash

npx exportdou@1.0.3 download "<task-id>" --output comments.csv --json

Excel 任务使用 .xlsx 文件名；下载不会改变创建时选定的文件格式。CLI 会校验文件大小和 SHA-256，再将临时文件改名为最终文件。目标文件已存在时，换一个文件名；只有用户同意覆盖该文件后才加 --force。

交付时提供本地文件，并说明实际行数、是否包含回复、是否只完成了一部分。不要把临时签名下载地址、API Key、服务商原始响应或内部游标发到对话中。

积分、历史和多个链接

bash

npx exportdou@1.0.3 credits --json
npx exportdou@1.0.3 history --limit 20 --json
npx exportdou@1.0.3 cancel "<task-id>" --json

创建时预留请求行数对应的积分，结束后按实际导出行数结算并释放差额。积分不足时说明缺口，给出充值页面，停止重复提交。

多个链接按顺序逐个处理，分别保存任务 ID。不要用 shell 循环、xargs、后台进程或并行 CLI 提交；遇到并发上限时等待已有任务结束，不要为腾出名额擅自取消用户的任务。

常见问题怎么处理

保留 JSON 标准输出和标准错误输出，先看实际错误码再决定下一步：

情况	处理方式
authentication_required / unauthorized	重新登录并让用户完成网页授权。
conflicting_options	检查是否混用了 --all、--replies 或 --limit，按上面的数量规则修正。
comment_count_unavailable	无法确定全部数量，改用用户确定的 --limit。
video_unavailable	说明链接当前不可用，请用户提供另一个公开链接。
paid_feature_required	说明回复或 Excel 的套餐要求；按用户选择升级，或改用一级评论 CSV。
rate_limited / concurrency_limit	等待建议间隔或已有任务结束，再查询；不要重建任务。
创建时 network_error / request_timeout	先查历史找回可能已创建的任务，不要盲目重提。
resume_already_active	原任务已在继续，直接查询同一个 ID。
resume_pages_missing 或其他 resume_* 拒绝原因	说明断点过期或不可继续，交付已有文件。
export_not_ready	按建议间隔查询原任务。
checksum_mismatch / size_mismatch	重新下载同一个结果，不要重新导出。

其他参数可运行 npx exportdou@1.0.3 --help 查看。抖评岛不是抖音官方服务，实际可导出范围取决于公开视频和服务返回结果。

相关链接

• 抖评岛官网
• CLI 使用说明
• API 文档
• 套餐和积分
• CLI 源码