> ## Documentation Index
> Fetch the complete documentation index at: https://aisa.one/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> - Base URLs: models `https://api.aisa.one/v1` (Gemini GenerateContent: `https://api.aisa.one/v1beta`); data APIs `https://api.aisa.one/apis/v1`. The `servers` of each operation in https://aisa.one/openapi.yaml is authoritative.
> - Auth: `Authorization: Bearer $AISA_API_KEY`. Never print, log, or commit the key.
> - MCP (preferred for agents): `https://mcp.aisa.one/mcp`, signed in with OAuth, so there is no key to paste.
> - Agent Skill: `npx skills add AIsa-team/agent-skills --skill aisa`. Fallback with the AIsa CLI: `aisa skills install aisa`.
> - Spending: docs, https://aisa.one/models, https://aisa.one/api, `/v1/models`, and MCP `search`, `list_categories`, `get_details`, `batch_quote`, and the `account` operation are free. Quote the exact calls before running them (MCP `batch_quote`, CLI `aisa quote --json`). If the quote reports `auto_execute_eligible: true`, run it unless the user set a tighter limit or asked only for a quote. Otherwise, tell the user in one message the planned calls, the quoted price, and a total USD budget for the task, then wait for approval. Direct HTTP calls follow the stricter rule at https://aisa.one/docs/get-started/cli.md#direct-http-fallback. Do not make paid calls to test availability. Full rule: https://aisa.one/llms.txt

# AIsa YouTube Search

> 通过 AIsa 搜索 YouTube 视频、频道和播放列表。

[在 GitHub 上查看 ->](https://github.com/AIsa-team/agent-skills/tree/main/social-media/aisa-youtube-search)

**通过 AIsa 进行 YouTube 发现。** 搜索视频、频道和播放列表，用于研究、趋势监控和内容规划。

## 安装

如果还没有安装 AIsa CLI，请先安装：

```bash theme={null}
npm install -g @aisa-one/cli
```

然后安装该技能：

```bash theme={null}
aisa skills install aisa-youtube-search
```

## 智能体可以用它做什么？

> [card] 视频发现
>
> 为查询或主题查找相关视频。

> [card] 频道研究
>
> 识别覆盖某个细分领域的频道。

> [card] 播放列表查询
>
> 查找 精选视频合集。

> [card] 主题探索
>
> 将 YouTube 作为研究工作流的输入。

## 何时使用

* 用户想搜索 YouTube 视频、频道或播放列表。
* 任务需要地区或语言过滤，但不想直接配置 Google API。
* 工作流可以使用 `AISA_API_KEY` 调用 AIsa YouTube search 端点。

## 何时不该使用

* 用户需要浏览器自动化、本地抓取或直接操作 YouTube 账号。
* 工作流必须避免把搜索请求发送到 `api.aisa.one`。
* 请求依赖不属于该包的本地 helper script。

## 快速参考

* 必需环境变量：`AISA_API_KEY`
* 端点：`https://api.aisa.one/apis/v1/youtube/search`
* 该包以 curl 为主，不附带本地 Python 客户端

## 设置

```bash theme={null}
export AISA_API_KEY="your-key"
```

## 常用命令

```bash theme={null}
curl -s "https://api.aisa.one/apis/v1/youtube/search?engine=youtube&q=machine+learning+tutorial" \
  -H "Authorization: Bearer $AISA_API_KEY"

curl -s "https://api.aisa.one/apis/v1/youtube/search?engine=youtube&q=AI+news&gl=us&hl=en" \
  -H "Authorization: Bearer $AISA_API_KEY"

curl -s "https://api.aisa.one/apis/v1/youtube/search?engine=youtube&q=python+tutorial&sp=EgIQAQ%3D%3D" \
  -H "Authorization: Bearer $AISA_API_KEY"
```

## 能力

* 使用 `q` 搜索 YouTube SERP 结果
* 用 `gl` 和 `hl` 按地区和语言过滤
* 用 `sp` 做分页或进一步收窄
* 返回结构化结果，可能包含 `videos` 或分组的 `sections`

## 防护边界

* 不要求 Google 凭据或浏览器 cookie。
* 不要声称结果是纯本地生成；它依赖 relay 请求。
* 不要编造不存在的过滤条件或参数。

## 安全说明

* 所有搜索请求都会发送到 `api.aisa.one`。
* 必需 secret：`AISA_API_KEY`。
* 该工作流不需要密码、浏览器自动化或本地抓取。

## 开始使用

1. 在 [aisa.one](https://aisa.one) 注册（新账户有 \$1 免费额度）。
2. 从控制台生成 API key。
3. 设置 key 并安装技能：
   ```bash theme={null}
   export AISA_API_KEY="your-key"
   npm install -g @aisa-one/cli
   aisa skills install aisa-youtube-search
   ```
4. 启动新的智能体会话，让运行时加载更新后的技能说明。

## 相关

> [card] [YouTube SERP](https://aisa.one/docs/zh/agent-skills/youtube-serp.md)
>
> 带丰富元数据的排序 YouTube SERP 结果。

> [card] [YouTube Search](https://aisa.one/docs/zh/agent-skills/youtube-search.md)
>
> 通用 YouTube 内容研究工作流。

> [card] [多源搜索](https://aisa.one/docs/zh/agent-skills/multi-search.md)
>
> 将 YouTube 与网页搜索和学术搜索 组合使用。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.