# Films Search

Search cloud drives for downloadable film and TV resources (movies, TV series, anime).

- Repository: https://github.com/freestylefly/wesight (965 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-10-01
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add freestylefly/wesight --skill films-search -g -a claude-code -y`
Codex: `npx skills add freestylefly/wesight --skill films-search -g -a codex -y`
Cursor: `npx skills add freestylefly/wesight --skill films-search -g -a cursor -y`
Gemini CLI: `npx skills add freestylefly/wesight --skill films-search -g -a gemini-cli -y`

## Description

Search cloud drives for downloadable film and TV resources (movies, TV series, anime). Use this skill when the user wants to download a specific movie or TV show. Do NOT use for general movie information, schedules, reviews, or recommendations.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Films Search Skill

搜索影视资源（电影、电视剧、动漫），通过实时爬虫深度抓取资源页面，从各网盘平台获取公开分享的资源链接。

## 前置条件

- **web-search** skill（必需，用于搜索发现资源页面）

## 命令

### 搜索资源

```bash
bash "$SKILLS_ROOT/films-search/scripts/film-search.sh" search "关键词" [选项]
```

**选项：**

| 参数 | 说明 | 默认值 |
|------|------|--------|
| `--pan <type>` | 筛选网盘类型: `quark`, `baidu`, `aliyun`, `uc`, `all` | `all` |
| `--quality <q>` | 筛选画质: `4k`, `1080p`, `720p`, `all` | `all` |
| `--limit <n>` | 每个平台最大结果数 | `5` |
| `--engine <e>` | 搜索引擎: `deep`, `web` | `deep` |

**引擎说明：**

- `deep`（默认，推荐）, web-search 搜索发现资源页面 + JavaScript 深度抓取提取网盘链接和提取码，结果最准确
- `web`, 仅从 web-search 搜索引擎摘要中提取链接（速度快，但准确率较低，不做深度抓取）

**示例：**

```bash
# 搜索所有平台的资源（默认使用深度搜索）
bash "$SKILLS_ROOT/films-search/scripts/film-search.sh" search "流浪地球2"

# 只搜夸克网盘 4K 资源
bash "$SKILLS_ROOT/films-search/scripts/film-search.sh" search "流浪地球2" --pan quark --quality 4k

# 限制结果数量
bash "$SKILLS_ROOT/films-search/scripts/film-search.sh" search "流浪地球2" --limit 10

# 使用浅层搜索（不深度抓取页面）
bash "$SKILLS_ROOT/films-search/scripts/film-search.sh" search "流浪地球2" --engine web
```

Windows 系统使用 PowerShell 脚本：
```powershell
powershell -File "$SKILLS_ROOT/films-search/scripts/film-search.ps1" search "流浪地球2" --pan quark
```

### 热门推荐

```bash
bash "$SKILLS_ROOT/films-search/scripts/film-search.sh" hot "2025年热门电影"
```

本质上是以推荐类关键词调用搜索，返回相关网盘资源。

### 解析跳转链接

```bash
bash "$SKILLS_ROOT/films-search/scripts/film-search.sh" resolve "https://example.com/goto/xxx"
```

当搜索结果中的链接需要二次跳转时，用此命令解析出真实网盘地址。

## Agent 使用流程

1. 用户说「帮我找 XXX 电影」→ 执行 `search "XXX"`
2. 解析返回的 JSON，提取网盘链接
3. 按网盘类型和画质分组呈现给用户
4. 如果结果中有提取码 (`extractCode`)，一并展示给用户
5. 如果结果中有 `pageUrl` 但没有直接 `url`，用 `resolve` 命令获取真实地址

**示例对话：**

> 用户：帮我找一下流浪地球2的夸克网盘资源，要4K的
>
> Agent：
> 1. 执行 `search "流浪地球2" --pan quark --quality 4k`
> 2. 从 JSON 结果中取出匹配项
> 3. 返回：标题 + 画质 + 夸克网盘链接 + 提取码（如有）

## 输出格式

所有命令输出 JSON，结构如下：

The rest: https://github.com/freestylefly/wesight/blob/HEAD/SKILLs/films-search/SKILL.md