前言¶
短视频和短剧立项时，编剧和创作者往往要先找对标作品：按类型、题材或热度筛一批可参考的剧本或 IP，再决定结构和市场位置。平时会在浏览器里逐个打开搜索站、社交平台或影视数据库，关键词换几轮，结果分散、重复多，也很难按统一格式汇总给 Agent 继续分析。
下面介绍 SkillHub 社区 Skill @user_6bedba2d/looking-for-scripts（页面名称：使用文字或文档实现找到匹配剧本或者生成匹配到剧本）。它把「理解检索意图 → 多引擎搜索 → 去重排序 → 结构化报告」写进通用 SKILL.md 工作流，并附带 Python 搜索脚本，适合在 Cursor 等支持 Skills 的 Agent 里启用。SkillHub 标注 requires_api_key=false，无需单独配置 API Key。
这是什么¶
一句话定位：面向短视频创作者与编剧的剧本发现 Skill，支持用文字或文档描述需求，按名称、类型、题材、热度等维度检索，并输出可聚合的搜索结果与报告框架。
| 项 | 说明 |
|---|---|
| 坐标 | @user_6bedba2d/looking-for-scripts |
| SkillHub 版本 | 1.0.1（来源：community，分类：content-creation） |
| 发布者 | user_6bedba2d（SkillHub 页面标注作者 Binan） |
| 官方入口 | SkillHub 技能页、API 索引 |
包内主文档为 SKILL.md（文档自标版本 1.2.3），与商店展示的 1.0.1 并存；安装后以 SkillHub 下载包内容为准。
核心功能¶
以下能力均来自 Skill 包内 SKILL.md、README.md 与 使用指南.md 的说明，已与本地安装包核对。
- 16 个搜索引擎：7 个国内（百度、必应中国、360、搜狗、微信搜索、神马、豆瓣）与 9 个国际（Google、Google 香港、DuckDuckGo、Yahoo、Startpage、Brave、Ecosia、Qwant、IMDB）。支持按中文/英文查询自动选引擎，也可在请求中指定
engines或region（cn/global/all）。 - 八种搜索类型：
SCREENPLAY_NAME（剧名）、SCREENPLAY_TYPE（类型）、SCREENPLAY_TOPIC（题材）、SCREENPLAY_TRENDING（热门）、SCREENPLAY_SIMILAR（相似）、SCREENPLAY_SOURCE（IP 来源）、SCREENPLAY_HOTTEST（爆款）、COMPETITOR_RESEARCH（竞品研究）。 - 结果处理：并行搜索（文档约定最多 5 个引擎同时、批次间隔与超时策略）、去重、相关性/热度等加权排序、结构化 JSON 与 Markdown 报告模板。
- 可执行脚本：
tools/搜索引擎/search.py、scripts/ScreenplayFinder.py；引擎 URL 配置在tools/搜索引擎/配置.json。 - 能力边界（文档明确限制）：不提供持续实时监控；不做剧本正文深度分析；批量搜索需控制频率（文档建议间隔约 10 秒，最佳实践提到 5 秒以上），并可能遇到反爬或引擎不可用时的降级。
安装与启用¶
1. 安装 SkillHub CLI¶
先确认本机是否已有 CLI：
command -v skillhub && skillhub --version
未安装时，按 SkillHub 安装说明 执行（节选）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI 可使用 bash -s -- --cli-only 参数。
2. 安装本 Skill 到 Agent 目录¶
安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 可能不会被识别。常见路径（摘自官方安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
安装命令：
skillhub install @user_6bedba2d/looking-for-scripts --dir ~/.cursor/skills/
将 ~/.cursor/skills/ 换成你实际使用的 Agent 路径。也可按 SkillHub 页面提示，让 AI 根据 https://skillhub.cn/install/skillhub.md 完成安装。
3. Python 依赖（使用命令行脚本时）¶
进入 Skill 安装目录后安装依赖：
pip install -r requirements.txt
启用 Skill 后，Agent 应加载该目录下的 SKILL.md；若走工具桥接，可对照包内 TOOL_BRIDGE.md、API_SCHEMA.md。
典型用法¶
在对话中交给 Agent¶
用自然语言或简短 JSON 描述需求即可，字段与包内契约一致：
- 必填：
search_query（关键词或需求描述）、search_type（上节八种类型之一）。 - 可选：
genre、style、region（默认all）、count（默认 10）、engines。
示例（按类型找复仇大女主向剧本）：
{
"search_query": "复仇 大女主 爽剧",
"search_type": "SCREENPLAY_TYPE",
"count": 10
}
Agent 按 SKILL.md 选择引擎、执行搜索并生成报告；输出形态可参考文档中的 status、results、summary 等字段。
命令行直接调用搜索脚本¶
在 Skill 根目录执行（路径与 SKILL.md 第十二章一致）：
python3 tools/搜索引擎/search.py --query "复仇大女主剧" --engines Baidu,Google --count 10
按类型搜索：
python3 tools/搜索引擎/search.py \
--query "复仇 大女主 爽剧" \
--search-type SCREENPLAY_TYPE \
--engines Baidu,Douban,WeChat \
--count 15
竞品向检索：
python3 tools/搜索引擎/search.py \
--query "复仇剧 市场分析 2026" \
--search-type COMPETITOR_RESEARCH \
--region cn \
--count 20
文档说明结果可写入 search_results.json（以脚本实际行为为准）。也可通过 ScreenplayFinder 类在 Python 中调用，见 README.md 方式 C。
文档与参考¶
包内 references/（搜索策略、剧本来源、类型热度、搜索协议）、examples/示例剧本_都市创业剧.txt、FAQ.md 用于细化关键词与报告格式，适合在 Agent 已启用 Skill 后按需 @ 引用。
适用场景与注意¶
适合谁
- 需要找对标热门剧本、做竞品或趋势调研的短视频团队与编剧。
- 希望用统一输入输出契约，把「搜剧本」交给 Agent 编排，而不是手工多站检索的用户。
使用注意
- 搜索结果依赖各搜索引擎当时返回的公开页面，为时点快照，不能替代版权授权或正式采购流程。
- 网络环境、反爬策略会导致部分引擎失败；Skill 文档描述了切换备用引擎与
partial状态，需接受结果不完整的情况。 - 商店元数据：SkillHub 评分 100000、下载 819（抓取时间以 SkillHub 页面为准）；标签
requires_api_key=false。 - 名称中的「生成匹配到剧本」在包内文档中侧重发现、聚合与报告；若需完整原创剧本生成，应结合其他创作流程，勿超出文档声明的「不能做什么」范围。
结尾¶
@user_6bedba2d/looking-for-scripts 把多引擎剧本检索和八种搜索类型收敛成 Agent 可执行的 Skill 与可选 CLI，适合立项前的对标搜集与结构化汇总。安装与说明以 SkillHub 为准：
- https://www.skillhub.cn/skills/user_6bedba2d/looking-for-scripts
- https://api.skillhub.cn/user_6bedba2d/looking-for-scripts
