TV Shows

Active

Your agent misremembers episodes, casts, and air dates; this returns real TV metadata and schedules.

8 tools

Television metadata: search shows and people, get series details, episode lists, and cast, look up shows by external ID, and pull the daily TV schedule. Data is licensed CC BY-SA; credit TVmaze and link back using the `url` fields in the responses. For movie facts, use the knowledge namespace (Wikipedia/Wikidata).

Knowledge & Referencetvshowsepisodesseriescast

Tools (8)

▶search_shows

Search TV shows by name, returning matches ranked by relevance.

0.1 credits/call ($0.0001) · 0.1 credit per call

Example prompts

“Search for the show Severance”
“Find the TV series Foundation”
“Look up shows named "The Office"”

Parameters

qstringrequired

Show name to search for.

API Usage

curl -X POST "https://skill.askfaro.com/skills/tv/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "Search for the show Severance"
  }
}'

CLI Usage

askfaro describe tv/search_shows

Install pip install askfaro-cli, then askfaro auth login.

▶show_details

Get full details for a TV show by its TVmaze ID, optionally embedding related data.

0.1 credits/call ($0.0001) · 0.1 credit per call

Example prompts

“Get full details for show 44933”
“Show the network and genres for this series”
“Get this show with its cast embedded”

Parameters

idintegerrequired

TVmaze show ID.

embedstringoptional

Related data to embed in the response.

API Usage

curl -X POST "https://skill.askfaro.com/skills/tv/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "Get full details for show 44933"
  }
}'

CLI Usage

askfaro describe tv/show_details

Install pip install askfaro-cli, then askfaro auth login.

▶show_episodes

List all episodes for a TV show, in order.

0.1 credits/call ($0.0001) · 0.1 credit per call

Example prompts

“List all episodes of show 44933”
“Get the episode guide for this series including specials”
“When did the episodes of this show air?”

Parameters

idintegerrequired

TVmaze show ID.

specialsintegeroptionaldefault: 0

Set to 1 to include special episodes.

API Usage

curl -X POST "https://skill.askfaro.com/skills/tv/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "List all episodes of show 44933"
  }
}'

CLI Usage

askfaro describe tv/show_episodes

Install pip install askfaro-cli, then askfaro auth login.

▶show_cast

Get the cast of a TV show (actors and the characters they play).

0.1 credits/call ($0.0001) · 0.1 credit per call

Example prompts

“Who is in the cast of show 44933?”
“List the actors and characters for this series”
“Get the cast of this show”

Parameters

idintegerrequired

TVmaze show ID.

API Usage

curl -X POST "https://skill.askfaro.com/skills/tv/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "Who is in the cast of show 44933?"
  }
}'

CLI Usage

askfaro describe tv/show_cast

Install pip install askfaro-cli, then askfaro auth login.

▶search_people

Search for people (actors, crew) by name.

0.1 credits/call ($0.0001) · 0.1 credit per call

Example prompts

“Search for the actor Adam Scott”
“Find the person Bryan Cranston”
“Look up people named "Pedro Pascal"”

Parameters

qstringrequired

Person name to search for.

API Usage

curl -X POST "https://skill.askfaro.com/skills/tv/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "Search for the actor Adam Scott"
  }
}'

CLI Usage

askfaro describe tv/search_people

Install pip install askfaro-cli, then askfaro auth login.

▶person_details

Get details for a person by TVmaze ID, optionally with their credits.

0.1 credits/call ($0.0001) · 0.1 credit per call

Example prompts

“Get details for person 344165”
“Show this actor's TV credits”
“What is the birthday of this person?”

Parameters

idintegerrequired

TVmaze person ID.

embedstringoptional

Related credits to embed.

API Usage

curl -X POST "https://skill.askfaro.com/skills/tv/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "Get details for person 344165"
  }
}'

CLI Usage

askfaro describe tv/person_details

Install pip install askfaro-cli, then askfaro auth login.

▶lookup_show

Find a TV show by an external ID (IMDb, TheTVDB, or TVRage).

0.1 credits/call ($0.0001) · 0.1 credit per call

Example prompts

“Find the TVmaze show for IMDb ID tt0944947”
“Look up the show with TheTVDB ID 81189”
“Map this IMDb ID to a TV show”

Parameters

imdbstringoptional

IMDb ID, e.g. "tt0944947".

tvrageintegeroptional

TVRage show ID.

thetvdbintegeroptional

TheTVDB show ID.

API Usage

curl -X POST "https://skill.askfaro.com/skills/tv/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "Find the TVmaze show for IMDb ID tt0944947"
  }
}'

CLI Usage

askfaro describe tv/lookup_show

Install pip install askfaro-cli, then askfaro auth login.

▶schedule

Get the TV schedule of episodes airing on a given day and country.

0.1 credits/call ($0.0001) · 0.1 credit per call

Example prompts

“What TV episodes air in the US on 2026-01-15?”
“Get the UK TV schedule for today”
“What's on TV in the US right now?”

Parameters

datestringoptional

Date in YYYY-MM-DD format.

countrystringoptional

ISO 3166-1 alpha-2 country code (e.g. "US", "GB").

API Usage

curl -X POST "https://skill.askfaro.com/skills/tv/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "What TV episodes air in the US on 2026-01-15?"
  }
}'

CLI Usage

askfaro describe tv/schedule

Install pip install askfaro-cli, then askfaro auth login.