Films Search Skill

Search for film and TV resources (movies, TV series, anime). Deeply crawl resource pages via real-time web scrapers to obtain publicly shared resource links from various cloud drive platforms.

Prerequisites

web-search skill (required, used to search and discover resource pages)

Commands

Search for Resources

bash

bash "$SKILLS_ROOT/films-search/scripts/film-search.sh" search "keyword" [options]

Options:

Parameter	Description	Default Value
`--pan <type>`	Filter by cloud drive type: `quark` , `baidu` , `aliyun` , `uc` , `all`	`all`
`--quality <q>`	Filter by video quality: `4k` , `1080p` , `720p` , `all`	`all`
`--limit <n>`	Maximum number of results per platform	`5`
`--engine <e>`	Search engine: `deep` , `web`	`deep`

Engine Explanation:

```
deep
```
(default, recommended) — Use web-search skill to find resource pages + JavaScript deep crawling to extract cloud drive links and access codes, with the most accurate results
```
web
```
— Only extract links from web-search engine summaries (fast, but lower accuracy, no deep crawling)

Examples:

bash

# Search resources on all platforms (uses deep search by default)
bash "$SKILLS_ROOT/films-search/scripts/film-search.sh" search "The Wandering Earth 2"

# Only search for 4K resources on Quark cloud drive
bash "$SKILLS_ROOT/films-search/scripts/film-search.sh" search "The Wandering Earth 2" --pan quark --quality 4k

# Limit the number of results
bash "$SKILLS_ROOT/films-search/scripts/film-search.sh" search "The Wandering Earth 2" --limit 10

# Use shallow search (no deep page crawling)
bash "$SKILLS_ROOT/films-search/scripts/film-search.sh" search "The Wandering Earth 2" --engine web

For Windows systems, use the PowerShell script:

powershell

powershell -File "$SKILLS_ROOT/films-search/scripts/film-search.ps1" search "The Wandering Earth 2" --pan quark

Hot Recommendations

bash

bash "$SKILLS_ROOT/films-search/scripts/film-search.sh" hot "2025 Popular Movies"

Essentially, it calls the search with recommendation-related keywords and returns relevant cloud drive resources.

Resolve Redirect Links

bash

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

When links in search results require a second redirect, use this command to resolve the real cloud drive address.

Agent Usage Flow

User says: "Help me find the movie XXX" → Execute
```
search "XXX"
```
Parse the returned JSON and extract cloud drive links
Present to the user grouped by cloud drive type and video quality
If there is an access code (
```
extractCode
```
) in the results, display it together
If there is a
```
pageUrl
```
but no direct
```
url
```
, use the
```
resolve
```
command to get the real address

Example Dialogue:

User: Help me find 4K Quark cloud drive resources for The Wandering Earth 2

Agent:
Execute
search "The Wandering Earth 2" --pan quark --quality 4k
Extract matching items from the JSON results

Return: Title + Video Quality + Quark Cloud Drive Link + Access Code (if any)

Output Format

All commands output JSON with the following structure:

json

{
  "success": true,
  "data": {
    "query": "The Wandering Earth 2",
    "total": 5,
    "results": [
      {
        "title": "Resource Title",
        "pan": "quark",
        "url": "https://pan.quark.cn/s/xxx",
        "quality": "4K",
        "extractCode": "ab12",
        "source": "deep-search",
        "pageUrl": "https://example.com/resource/123"
      }
    ]
  }
}

Field Explanations:

```
pan
```
: Cloud drive type —
```
quark
```
(Quark),
```
baidu
```
(Baidu),
```
aliyun
```
(Alibaba),
```
uc
```
(UC),
```
magnet
```
(Magnet Link)
```
quality
```
: Detected video quality —
```
4K
```
,
```
1080P
```
,
```
720P
```
, empty string if not detected
```
source
```
: Result source —
```
deep-search
```
(Deep Crawling),
```
web-search
```
(Search Summary)
```
url
```
: Directly accessible cloud drive sharing link
```
extractCode
```
: Access code/password (if detected)
```
pageUrl
```
: URL of the source page for the result

Configuration

Edit

films-search/.env

to customize preferences:

bash

# Preferred cloud drive types (comma-separated, earlier ones are prioritized)
FILM_SEARCH_PREFERRED_PAN=quark,aliyun,baidu,uc

# Deep search toggle (recommended to enable)
FILM_SEARCH_DEEP_ENABLED=true

# Maximum number of result pages accessed per search
FILM_SEARCH_DEEP_MAX_PAGES=6

# Number of concurrent page crawls
FILM_SEARCH_DEEP_CONCURRENCY=4

Notes

It is recommended to use Chinese film titles for the best search results
Deep search (
```
--engine deep
```
) takes 2-3 seconds longer than shallow search, but results are much more accurate
Deep search requires the web-search skill to be enabled; the first search may require waiting for the browser to start
Cloud drive sharing links may become invalid at any time, so it is recommended to use them as soon as possible

Disclaimer

This tool is for personal study and research only. It does not host, distribute, or provide any copyrighted content, and only aggregates publicly accessible links from search engines. Please comply with the laws and regulations of your region.

films-search

NPX Install

Tags

SKILL.md Content (Chinese)

Films Search Skill

Prerequisites

Commands

Search for Resources

Hot Recommendations

Resolve Redirect Links

Agent Usage Flow

Output Format

Configuration

Notes

Disclaimer