Search TikTok's public Ad Library for the ads an advertiser is running. Use the registered advertiser name (exact, case-sensitive — e.g. 'Anysphere', not 'Cursor'), or a keyword to discover ads by topic. Returns ad ids, run dates, spend/impression bands and media URLs. For complete analysis of visual elements, colors, design, or creative content, you MUST also use analyze_ad_video (passing ad_id) or analyze_ad_image on the media returned by each ad.

Get detailed information about a specific TikTok ad including the full creative, landing page, country targeting, engagement metrics and a fresh playable video URL. Use this with an ad_id from search_tiktok_ads. Essential for analyzing ad content and extracting media URLs for visual analysis.

REQUIRED for analyzing images from TikTok ads. Download and analyze ad images (cover frames and static creatives) to extract visual elements, text content, colors, people, brand elements, and composition details. This tool should be used for EVERY image URL returned by search_tiktok_ads when doing comprehensive analysis. Uses intelligent caching so multiple image analysis calls are efficient and cost-free.

REQUIRED for checking media cache status and storage usage. Use this tool when users ask about cache statistics, storage space used by cached media (images and videos), or how many files have been analyzed and cached. Essential for cache management and monitoring.

REQUIRED for finding previously analyzed ad media (images and videos) in cache. Use this tool when users want to search for cached media by brand name, find media with people, search by colors, or filter by media type. Essential for retrieving past analysis results without re-downloading media.

REQUIRED for cleaning up old cached media files (images and videos) and freeing disk space. Use this tool when users want to remove old cached media, clean up storage space, or when cache becomes too large. Essential for cache maintenance and storage management.

REQUIRED for analyzing video ads from TikTok. Downloads and analyzes ad videos using Gemini's video understanding to extract the hook, scene-by-scene storytelling, on-screen text, audio/voiceover, pacing and brand messaging. ALWAYS pass ad_id — TikTok CDN URLs are signed and expire within minutes, and ad_id lets the server fetch a fresh URL and cache results stably across sessions. Uses intelligent caching for efficiency.