Automation
Plugin
moviepilot
基于 NAStool 部分代码重新设计，聚焦自动化核心需求，减少问题同时更易于扩展和维护。
Plugin Signal75/100Solid
maintained100
capable56
documented50
adopted86
Install
$ npx -y skills add jxxghp/moviepilot --agent claude-code
Run the curl in your terminal, the rest in Claude Code.
Stats
11,520
Stars
1,451
Forks
Active
Maintenance
Python
Language
GPL-3.0
License
23m ago
Last commit
3y ago
Created
Repo: jxxghp/moviepilot
What's inside
Skills
14/anysearchAPI key for higher rate limits. Anonymous access available with lower rate limits./browser-useUse this skill when the user asks the agent to open, browse, inspect, extract content from, click through, fill forms on, screenshot, or verify a web page with a browser. Also use it for MoviePilot scenarios that need browser interaction, such as checking a site page, confirming/command-dispatchUse this skill when the user's intent is to execute a system or plugin function. Applicable scenarios include: 1) The user sends a slash command starting with / (e.g. /cookiecloud, /sites, /subscribes, etc.); 2) The user describes an action in natural language that can be/create-moviepilot-pluginUse this skill when the user asks to create, modify, debug, validate, or scaffold a MoviePilot local plugin. Covers MoviePilot V2 plugin development, _PluginBase implementations, package.v2.json/package.json market metadata, plugins.v2/plugins source layout,/create-moviepilot-skillUse this skill when the user asks to create, scaffold, update, or review a MoviePilot agent skill. This includes adding a new built-in skill under the repository `skills/` directory, editing an existing built-in skill, writing `SKILL.md` frontmatter and workflow instructions,/database-operationUse this skill when you need to inspect, query, maintain, or carefully modify the MoviePilot database. This skill uses the bundled scripts/mp-db.py helper, which reads MoviePilot local settings itself and never requires database passwords or full PostgreSQL DSNs in the agent
Show all 14 skillsShow fewer
/feedback-issueUse this skill ONLY when the user EXPLICITLY requests filing an upstream issue for MoviePilot core, frontend, or an installed plugin, for example "反馈 issue", "提 issue", "报 bug", "给 MP 提 issue", "让上游修一下", "提交错误报告", "提问题", "提需求", "功能请求", or English "file an issue / report a bug //generate-identifiersUse this skill when a user provides a torrent name or file name and wants to fix recognition issues, or asks to add/manage custom identifiers (自定义识别词). This skill generates identifier rules based on the WordsMatcher preprocessing logic, checks for duplicates against existing/moviepilot-apiUse this skill when you need to call MoviePilot REST API endpoints directly with the bundled Python client. Covers MoviePilot HTTP endpoints across media search, downloads, subscriptions, library management, site management, system administration, plugins, workflows, and more./moviepilot-cliUse this skill when the user asks to operate MoviePilot through the local `moviepilot tool` MCP CLI for normal product workflows: media search, torrent search, downloads, subscriptions, downloader tasks, library checks, sites, schedulers, workflows, and messages. Prefer/moviepilot-updateUse this skill when you need to check MoviePilot versions, restart MoviePilot, or trigger a MoviePilot upgrade. Prefer the built-in system APIs instead of docker commands or manual file replacement. If auto-update on restart is already enabled, just restart. If it is disabled,/organize-filesUse this skill when the user asks the MoviePilot agent to identify and organize downloaded/local media files that automatic transfer cannot handle. Typical triggers include: manually organize a file or folder, organize unrecognized downloads, fix files stuck in a download/publish-moviepilot-pluginUse this skill when the user asks to publish, upload, sync, pull, push, diff, or maintain a MoviePilot local plugin in a GitHub repository. Covers using the configured MoviePilot GitHub token, PLUGIN_LOCAL_REPO_PATHS local plugin repositories, package.json/package.v2.json/transfer-failed-retryUse this skill when you need to retry failed file transfers/organizations. Given one or more failed transfer history record IDs, this skill guides you through querying the failure details, deleting the old records, and re-identifying and re-organizing the files. Supports batch
README
1MoviePilot
简体中文 | English
基于 NAStool 部分代码重新设计，聚焦自动化核心需求，减少问题同时更易于扩展和维护。
仅用于学习交流使用，请勿在任何国内平台宣传该项目！
发布频道：https://t.me/moviepilot_channel
主要特性
- 聚焦影视自动化的核心流程：订阅、搜索、下载、整理、刮削、媒体库刷新与消息通知。
- 前后端分离，后端基于 FastAPI，前端基于 Vue 3，部署和扩展边界更清晰。
- 支持下载器、媒体服务器、元数据源、消息渠道、插件、工作流和 AI Agent 等能力组合。
- 更完整的功能介绍、截图和使用入口见官网：https://movie-pilot.org
安装使用
推荐优先使用 Docker 部署。V3 使用独立镜像 jxxghp/moviepilot-v3，V2 和旧版镜像保持原命名。Compose 示例、环境变量、目录映射和升级方式以官方 Wiki 为准：
- 官方 Wiki：https://wiki.movie-pilot.org
- PostgreSQL 部署说明：docs/postgresql-setup.md
也可以使用本地 CLI 以源码模式安装和管理 MoviePilot：
curl -fsSL https://raw.githubusercontent.com/jxxghp/MoviePilot/v3/scripts/bootstrap-local.sh | bash
安装完成后使用 moviepilot 命令完成初始化、启动、停止、更新和配置查看。完整命令见 docs/cli.md。
Agent
-
MoviePilot 自带智能体能力，可在完成模型配置后，通过自然语言调用系统工具，辅助完成搜索、订阅、下载、整理、排障等管理任务。
-
其它智能体可以导入本仓库的
skills/目录以获得 MoviePilot 操作能力；支持skillsCLI 的环境可使用：npx skills add https://github.com/jxxghp/MoviePilot内置 Skills 列表见 skills/，自定义 Skill 可参考 skills/create-moviepilot-skill/SKILL.md。
-
其它 MCP 客户端可以通过 MoviePilot 的 MCP 端点
/api/v1/mcp调用工具，认证方式、客户端配置和工具 API 见 docs/mcp-api.md。
参与开发
开发前请先阅读仓库规则和本地环境说明，保持变更聚焦，通过测试后再提交 PR。常用入口：
- 文档规则入口：docs/rules/README.md
- 开发环境与本地源码运行：docs/development-setup.md
- 测试说明：docs/testing.md
- 新站点适配采集与 Feature Request 提交：docs/site-adapter-capture.md
- REST API 文档：https://api.movie-pilot.org
- 插件开发说明：https://wiki.movie-pilot.org/zh/plugindev
相关项目
- MoviePilot-Frontend
- MoviePilot-Resources
- MoviePilot-Plugins
- MoviePilot-Server
- MoviePilot-Rust
- MoviePilot-Wiki
免责申明
- 本软件仅供学习交流使用，任何人不得将本软件用于商业用途，任何人不得将本软件用于违法犯罪活动，软件对用户行为不知情，一切责任由使用者承担。
- 本软件代码开源，基于开源代码进行修改，人为去除相关限制导致软件被分发、传播并造成责任事件的，需由代码修改发布者承担全部责任，不建议对用户认证机制进行规避或修改并公开发布。
- 本项目不接受捐赠，没有在任何地方发布捐赠信息页面，软件本身不收费也不提供任何收费相关服务，请仔细辨别避免误导。
贡献者
File tree
1010jxxghp/moviepilotView on GitHub
.coveragerc
.cursorrules
.dockerignore
.github/
copilot-instructions.md
ISSUE_TEMPLATE/
bug_report.yml
config.yml
feature_request.yml
rfc.yml
workflows/
beta.yml
build-v3.yml
issues.yml
pr-agent.yml
pylint.yml
site-adapter-collector.yml
test.yml
.gitignore
.pylintrc
AGENTS.md
app/
app.ico
__init__.py
agent/
__init__.py
callback/
__init__.py
defaults/
CURRENT_PERSONA.md
personas/
aloof/
PERSONA.md
anime/
PERSONA.md
catgirl/
PERSONA.md
concise/
PERSONA.md
cute/
PERSONA.md
default/
PERSONA.md
disdain/
PERSONA.md
guide/
PERSONA.md
moe/
PERSONA.md
subagents/
download-diagnostician/
SUBAGENT.md
general-purpose/
SUBAGENT.md
media-researcher/
SUBAGENT.md
moviepilot-explorer/
SUBAGENT.md
resource-searcher/
SUBAGENT.md
subscription-analyst/
SUBAGENT.md
system-diagnostician/
SUBAGENT.md
llm/
__init__.py
capability.py
helper.py
models.json
provider.py
server_tools.py
mcp.py
memory/
__init__.py
middleware/
__init__.py
activity_log.py
jobs.py
memory.py
patch_tool_calls.py
runtime_config.py
skills.py
subagents.py
tool_selection.py
usage.py
utils.py
prompt/
__init__.py
System Core Prompt.txt
System Tasks.yaml
transfer_redo.py
runtime.py
tools/
__init__.py
base.py
factory.py
impl/
__init__.py
_command_safety.py
_file_write_utils.py
_filter_rule_utils.py
_plugin_tool_utils.py
_system_setting_utils.py
_terminal_session.py
_torrent_search_utils.py
add_custom_filter_rule.py
add_download_tasks.py
add_rule_group.py
add_subscribe.py
ask_user_choice.py
browse_webpage.py
create_agent_task.py
delete_agent_task.py
delete_custom_filter_rule.py
delete_download_history.py
delete_download_tasks.py
delete_rule_group.py
delete_subscribe.py
delete_transfer_history.py
edit_file.py
execute_command.py
get_recommendations.py
get_search_results.py
install_plugin.py
list_directory.py
list_slash_commands.py
mcp.py
query_agent_tasks.py
query_builtin_filter_rules.py
query_custom_filter_rules.py
query_custom_identifiers.py
query_directory_settings.py
query_doctor_report.py
query_download_tasks.py
query_downloaders.py
query_episode_schedule.py
query_installed_plugins.py
query_library_exists.py
query_library_latest.py
query_market_plugins.py
query_media_detail.py
query_personas.py
query_plugin_capabilities.py
query_plugin_config.py
query_plugin_data.py
query_popular_subscribes.py
query_rule_groups.py
query_schedulers.py
query_site_userdata.py
query_sites.py
query_subscribe_history.py
query_subscribe_shares.py
query_subscribes.py
query_system_settings.py
query_transfer_history.py
query_workflows.py
read_file.py
recognize_captcha.py
recognize_media.py
reload_plugin.py
run_agent_task.py
run_scheduler.py
run_slash_command.py
run_workflow.py
scrape_metadata.py
search_media.py
search_person_credits.py
search_person.py
search_subscribe.py
search_torrents.py
search_web.py
send_local_file.py
send_message.py
send_voice_message.py
switch_persona.py
test_site.py
transfer_file.py
uninstall_plugin.py
update_agent_task.py
update_custom_filter_rule.py
update_custom_identifiers.py
update_download_tasks.py
update_persona_definition.py
update_plugin_config.py
update_rule_group.py
update_site_cookie.py
update_site.py
update_subscribe.py
update_system_settings.py
write_file.py
manager.py
tags.py
api/
__init__.py
apiv1.py
apiv2_utils.py
apiv2.py
endpoints/
__init__.py
agent.py
anilist.py
anthropic.py
auth.py
bangumi.py
dashboard.py
discover.py
douban.py
download.py
history.py
llm.py
login.py
mcp.py
media.py
mediaserver.py
message.py
mfa.py
music.py
notification.py
openai.py
plugin.py
recommend.py
search.py
site.py
storage.py
subscribe.py
system.py
tmdb.py
torrent.py
transfer.py
user.py
webhook.py
workflow.py
openai_utils.py
servarr.py
servcookie.py
chain/
__init__.py
anilist.py
bangumi.py
dashboard.py
douban.py
download.py
media.py
mediaserver.py
message.py
music.py
recommend.py
search.py
site.py
skills.py
storage.py
subscribe.py
system.py
tmdb.py
torrents.py
transfer.py
tvdb.py
user.py
webhook.py
workflow.py
cli.py
command.py
core/
__init__.py
auth.py
cache.py
config.py
context.py
event.py
meta/
__init__.py
customization.py
infopath.py
metaanime.py
metabase.py
metamusic.py
metavideo.py
releasegroup.py
streamingplatform.py
words.py
metainfo.py
module.py
plugin.py
security.py
db/
__init__.py
agentchat_oper.py
agenttask_oper.py
downloadfailure_oper.py
downloadhistory_oper.py
init.py
mediaserver_oper.py
message_oper.py
models/
__init__.py
agentchat.py
agenttask.py
downloadfailure.py
downloadhistory.py
mediaserver.py
message.py
passkey.py
plugindata.py
site.py
siteicon.py
sitestatistic.py
siteuserdata.py
subscribe.py
subscribehistory.py
systemconfig.py
transferhistory.py
user.py
userconfig.py
workflow.py
plugindata_oper.py
site_oper.py
subscribe_oper.py
subscribehistory_oper.py
systemconfig_oper.py
transferhistory_oper.py
user_oper.py
userconfig_oper.py
workflow_oper.py
doctor/
__init__.py
checks.py
formatters.py
models.py
runner.py
factory.py
helper/
__init__.py
agent.py
audio.py
browser.py
cloudflare.py
cookie.py
cookiecloud.py
directory.py
display.py
doh.py
downloader.py
format.py
image.py
interaction.py
locale.py
market.py
mediaserver.py
message.py
module.py
nfo.py
notification.py
ocr.py
package.py
passkey.py
plugin.py
progress.py
redis.py
resource.py
rss.py
rule.py
scraper.py
server.py
service.py
skill.py
storage.py
system.py
thread.py
torrent.py
twofa.py
webpush.py
locales/
en-US.json
zh-CN.json
zh-TW.json
log.py
main.py
modules/
__init__.py
anilist/
__init__.py
anilist.py
bangumi/
__init__.py
bangumi.py
discord/
__init__.py
discord.py
douban/
__init__.py
apiv2.py
scraper.py
emby/
__init__.py
emby.py
fanart/
__init__.py
feishu/
__init__.py
feishu.py
... 734 moreFAQ
moviepilot is a Claude Code plugin with 14 hand-picked skills for automation work, indexed on Flowy. Install it with the command on its page. It includes anysearch, browser-use, command-dispatch. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.
- What is moviepilot?
- 基于 NAStool 部分代码重新设计，聚焦自动化核心需求，减少问题同时更易于扩展和维护。
- How do I install moviepilot?
- Run these in Claude Code: npx -y skills add jxxghp/moviepilot --agent claude-code. Then prompt normally.
- Does moviepilot auto-invoke its skills?
- Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.
- Is moviepilot free?
- Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.