use-youtube-data-mcp

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Use YouTube Data MCP

使用YouTube Data MCP

Workflow

工作流

Confirm Node.js is installed and
```
npm
```
and
```
npx
```
work.
Ask user for API key only when missing.
Detect client and OS, then write MCP config.
Verify MCP connectivity and run capability discovery:
- ```
tools/list
```
- ```
get_patch_notes
```
Strongly recommend helper skill and Python dependency setup for users who want the full local document and spreadsheet workflow.
Explain to user how to use current MCP abilities in plain language.

确认已安装Node.js，且
```
npm
```
和
```
npx
```
可正常使用。
仅当缺少API密钥时向用户请求。
检测客户端和操作系统，然后编写MCP配置。
验证MCP连通性并运行功能发现：
- ```
tools/list
```
- ```
get_patch_notes
```
对于希望使用完整本地文档和电子表格工作流的用户，强烈推荐安装辅助Skill并配置Python依赖。
用通俗易懂的语言向用户解释如何使用当前MCP的功能。

Step 1: Confirm Node.js Tooling

步骤1：确认Node.js工具链

Assume this skill has already been installed with
```
npx skills add ...
```
. Do not try to self-update or reinstall this skill unless the user explicitly asks.
First check the latest stable Node.js release using an official Node.js source when internet access is available.
Then verify local tooling:

bash

node -v
npm -v
npx -v

If
```
node
```
is missing, the agent should install Node.js directly instead of asking the user to do it manually.
If installation requires elevated permissions, the agent should request permission and then perform the installation itself once permission is granted.
If
```
node
```
exists but
```
npm
```
or
```
npx
```
fails, treat the local Node.js installation as incomplete and have the agent repair or reinstall Node.js directly instead of sending the user away to do it.
After Node.js is confirmed, continue with MCP setup. Do not block on Python here.

假设本Skill已通过
```
npx skills add ...
```
安装完成。除非用户明确要求，否则不要尝试自我更新或重新安装本Skill。
当有网络连接时，首先通过Node.js官方源检查最新稳定版Node.js。
然后验证本地工具：

bash

node -v
npm -v
npx -v

如果缺少
```
node
```
，Agent应直接安装Node.js，而非让用户手动操作。
如果安装需要提升权限，Agent应先请求权限，获得许可后再自行执行安装。
如果
```
node
```
存在但
```
npm
```
或
```
npx
```
无法正常工作，将本地Node.js安装视为不完整，Agent应直接修复或重新安装Node.js，而非让用户自行处理。
确认Node.js正常后，继续MCP设置。此处无需因Python未安装而停滞。

Step 2: Ask For API Key

步骤2：请求API密钥

If API key is not already provided in env or config, ask user once:
- ```
Please provide your MCP API key for https://mkterswingman.com
```
Never echo full key in logs; mask with prefix/suffix in outputs.

如果环境变量或配置中未提供API密钥，仅向用户请求一次：
- ```
请提供您用于https://mkterswingman.com的MCP API密钥
```
切勿在日志中回显完整密钥；在输出中使用前缀/后缀掩码处理。

Step 3: Configure MCP Client

步骤3：配置MCP客户端

Read references/client-configs.md.
Detect environment and patch the matching MCP config file.
Register this server using:
- URL:
```
https://mkterswingman.com/mcp
```
- Header:
```
Authorization: Bearer <API_KEY>
```
- Transport: Streamable HTTP (or tool-specific equivalent)

阅读references/client-configs.md。
检测环境并修改匹配的MCP配置文件。
使用以下信息注册本服务器：
- URL:
```
https://mkterswingman.com/mcp
```
- 请求头:
```
Authorization: Bearer <API_KEY>
```
- 传输方式: 可流式HTTP（或工具特定的等效方式）

Step 4: Post-Install Capability Discovery

步骤4：安装后功能发现

Immediately call:
- ```
tools/list
```
- ```
get_patch_notes
```
Summarize:
- Newest features and limits
- Which tools support batch input
- Recommended usage patterns for the current release

立即调用：
- ```
tools/list
```
- ```
get_patch_notes
```
总结以下内容：
- 最新功能和限制
- 哪些工具支持批量输入
- 当前版本的推荐使用模式

Step 5: Strongly Recommended Local File Workflow Setup

步骤5：强烈推荐的本地文件工作流设置

For most users, strongly recommend this step after MCP setup succeeds. It enables the full local document and spreadsheet workflow around the MCP.
Install optional helper skills with public GitHub URLs:

bash

npx -y skills add https://github.com/anthropics/skills/tree/main/skills/docx --yes
npx -y skills add https://github.com/anthropics/skills/tree/main/skills/xlsx --yes
npx -y skills add https://github.com/anthropics/skills/tree/main/skills/pptx --yes

If the active agent requires explicit targets, add the same
```
--agent ... --global
```
options the user used for the main skill install.
Explain that helper skill installation is separate from MCP setup. The YouTube Data MCP is already usable even before these helpers are installed, but most users will benefit from adding them.
For Python-backed spreadsheet workflows, assume Python may be missing and verify the interpreter first:

bash

python3 --version

If
```
python3
```
is unavailable, also check:

bash

python --version

If neither
```
python3
```
nor
```
python
```
is available, ask the agent to search for the latest official Python installation method for the user's current OS before giving instructions.
If Python is available but the spreadsheet stack is missing, ask the agent to search for the latest recommended install method for
```
pandas
```
and
```
openpyxl
```
on the user's current platform before giving instructions.

对于大多数用户，在MCP设置成功后强烈推荐此步骤。它能围绕MCP实现完整的本地文档和电子表格工作流。
通过公开GitHub URL安装可选的辅助Skill：

bash

npx -y skills add https://github.com/anthropics/skills/tree/main/skills/docx --yes
npx -y skills add https://github.com/anthropics/skills/tree/main/skills/xlsx --yes
npx -y skills add https://github.com/anthropics/skills/tree/main/skills/pptx --yes

如果当前Agent需要明确目标，添加用户安装主Skill时使用的相同
```
--agent ... --global
```
选项。
说明辅助Skill的安装与MCP设置是分开的。即使未安装这些辅助Skill，YouTube Data MCP也已可使用，但大多数用户会因添加它们而受益。
对于基于Python的电子表格工作流，假设Python可能未安装，先验证解释器：

bash

python3 --version

如果
```
python3
```
不可用，再检查：

bash

python --version

如果
```
python3
```
和
```
python
```
都不可用，让Agent为用户当前的操作系统搜索最新的官方Python安装方法，再给出指导。
如果Python可用但电子表格依赖栈缺失，让Agent为用户当前平台搜索
```
pandas
```
和
```
openpyxl
```
的最新推荐安装方法，再给出指导。

Step 6: User Briefing Template

步骤6：用户简报模板

Tell user:
- Besides subtitle fetching, most tools support batch inputs.
- User can paste multiple links directly in chat.
- User can also provide Excel, CSV, and DOCX for link extraction after the strongly recommended helper setup.
- Results can be written back to local DOCX or Excel after the strongly recommended helper setup.

告知用户：
- 除字幕提取外，大多数工具支持批量输入。
- 用户可直接在聊天中粘贴多个链接。
- 在完成强烈推荐的辅助Skill设置后，用户还可提供Excel、CSV和DOCX文件用于链接提取。
- 在完成强烈推荐的辅助Skill设置后，结果可写回本地DOCX或Excel文件。

Notes

注意事项

Keep subtitle mode as single-video per request unless project rules change.
If a client config path is uncertain, scan candidate config files and pick the one that already contains MCP settings first.
After changing client config, remind user to restart the client if required.
Do not assume Codex-specific directories exist. Use agent-neutral commands unless the user explicitly states a client-specific path.

除非项目规则更改，否则字幕模式保持为每次请求处理单个视频。
如果客户端配置路径不确定，扫描候选配置文件，优先选择已包含MCP设置的文件。
修改客户端配置后，提醒用户是否需要重启客户端。
不要假设Codex特定目录存在。除非用户明确指定客户端特定路径，否则使用Agent无关的命令。