Media Discovery

Available Tools

Giphy

• Tool ID:

  giphySearch

• Secrets:

  giphy.apiKey

• Use when: User wants a GIF reaction, animated illustration, or fun visual content
• Capabilities:
  • Search GIFs by keyword with trending, relevance, and recency sorting
  • Return multiple results with preview URLs and embed links
  • Filter by rating (G, PG, PG-13, R)
  • Access trending GIFs for current popular content
• Tips: Use specific keywords for better results; "happy dance" beats "happiness"

Image Search

• Tool ID:

  imageSearch

• Secrets:

  serper.apiKey

  or

  unsplash.apiKey

• Use when: Need stock photos, illustrations, or reference images
• Capabilities:
  • Search across Google Images, Unsplash, and other providers
  • Filter by size (large, medium, icon), type (photo, illustration, clipart), color
  • Return high-resolution URLs suitable for social media or documents
  • License filtering for commercial-safe images
• Tips: Add style descriptors ("minimalist", "flat design", "photography") for targeted results

OMDB (Open Movie Database)

• Tool ID:

  omdbSearch

  ,

  omdbGet

• Secrets:

  omdb.apiKey

• Use when: Looking up movie/TV show information — ratings, cast, plot, awards
• Capabilities:
  • Search by title, year, and type (movie, series, episode)
  • Get detailed metadata: plot, director, actors, genre, ratings (IMDb, Rotten Tomatoes, Metacritic)
  • Box office data and awards information
  • Poster URLs for visual display
• Tips: Use IMDb ID for exact matches; title search can return multiple results

Letterboxd

• Tool ID:

  letterboxdSearch

  ,

  letterboxdProfile

  ,

  letterboxdReviews

• Secrets: None required (public data)
• Use when: Want film community opinions, curated lists, or social film discovery
• Capabilities:
  • Search films and find Letterboxd ratings
  • View user profiles and watchlists
  • Read community reviews and popular lists
  • Discover films by genre, decade, or popularity
• Tips: Letterboxd ratings tend to differ from IMDb — more arthouse-friendly

Voice Synthesis

• Tool ID:

  voiceSynthesize

  ,

  voiceListVoices

• Secrets:

  elevenlabs.apiKey

  or

  openai.apiKey

• Use when: Need to generate spoken audio from text — podcasts, voiceovers, accessibility
• Capabilities:
  • Text-to-speech with multiple voices and languages
  • Voice cloning (ElevenLabs) with custom voice profiles
  • Adjustable speed, pitch, and stability
  • Output formats: MP3, WAV, OGG
  • Streaming audio for real-time playback
• Tips: Use SSML tags for fine-grained control over pauses and emphasis

Media Upload

• Tool ID:

  mediaUpload

  ,

  mediaTag

  ,

  mediaSearch

• Secrets: None (uses local media library)
• Use when: Uploading images/videos/audio to the media library for reuse across channels
• Capabilities:
  • Upload files with auto-generated thumbnails
  • Tag media with keywords for searchable organization
  • Search existing library by tags, type, or date
  • Serve media via URL for channel posting
• Tips: Tag media consistently (brand name, campaign, content type) for easy retrieval

Workflow Patterns

Social Post with Media

1. Determine content theme
2. Search for relevant images with

   imageSearch

   or GIFs with

   giphySearch

3. Upload chosen media to library with

   mediaUpload

4. Use the media URL when composing the social post

Movie Recommendation

1. Search OMDB for the requested genre or title
2. Cross-reference with Letterboxd reviews for community sentiment
3. Present ratings from both sources with poster images
4. Generate a voice summary if requested

Audio Content Creation

1. Write the script or talking points
2. Select an appropriate voice with

   voiceListVoices

3. Synthesize audio with

   voiceSynthesize

4. Upload to media library for distribution

Media Library Management

1. Audit existing media with

   mediaSearch

2. Tag untagged assets with

   mediaTag

3. Identify gaps (missing platform-specific crops, outdated assets)
4. Upload new assets organized by campaign or content type

Best Practices

• Rights awareness — Giphy GIFs are generally embeddable; stock photos may need attribution
• Format matching — use JPEG for photos, PNG for graphics with transparency, GIF for animations
• Voice quality — always preview voice synthesis output before publishing
• Media library hygiene — tag consistently, delete outdated assets, use descriptive filenames
• Resolution — use high-res images for social posts; downscale for thumbnails and previews