media_search

Search Plex libraries semantically by title, actor, genre, or description.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/MichaelYagi/mcp_a2a --skill media-search
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: media_search
Source: https://github.com/MichaelYagi/mcp_a2a/tree/main/servers/plex/skills/media_search
Command: npx skills add https://github.com/MichaelYagi/mcp_a2a --skill media-search

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Plex libraries can be large, making manual searching by title, actor, or genre time-consuming. This skill enables semantic search to locate movies and TV shows by title, actor, genre, or description, delivering faster, more relevant results.

Core Features & Use Cases

  • Semantic search over Plex metadata: Find media using natural-language queries, matching across title, cast, genre, and description.
  • Multi-attribute filtering & ranking: Combine criteria like year, rating, and genre to refine results with ranked outputs.
  • Use Case: Example: "Show me sci-fi films starring Natalie Portman" returns a ranked list of matches for quick selection.
  • Easy integration: Works with standard Plex libraries and surfaces results for quick playback or bookmarking.

Quick Start

Use this skill to search your Plex library with a natural-language query, e.g., "Find comedies from the 1990s" to see matching titles.

Frequently Asked Questions about media_search

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search my Plex library using natural language instead of exact titles?

Semantic search over Plex metadata matches natural-language queries across titles, cast, genres, and descriptions to locate movies and TV shows. It interprets phrases like "sci-fi films starring Natalie Portman" and returns ranked results.

Can I filter and rank Plex media search results by year or rating?

Plex media search supports multi-attribute filtering and ranking by criteria like year and rating. This refines natural-language query outputs to deliver highly relevant matches for quick selection.

What do I need to run semantic search over my home Plex server?

Semantic search requires a running home Plex server and a runtime environment with network access. The skill utilizes Plex metadata APIs to execute queries and retrieve ranked matches.

What is the best way to find movies in a large Plex library by actor or genre?

Using semantic search is an efficient way to find Plex media by actor or genre. It scans library metadata to deliver faster, more relevant results than manual browsing, handling large collections easily.

Does Plex semantic search work for both movies and TV shows?

Semantic search targets both movies and TV shows stored on a Plex server. It matches natural-language queries against metadata attributes including titles, descriptions, and cast members.

Why does Plex semantic search require network access?

Network access is required because the semantic search component queries Plex metadata APIs remotely. This connectivity allows the skill to retrieve, rank, and return library matches.