# ConvertFleet MCP — Full Tool Catalog

ConvertFleet MCP server endpoint: https://convertfleet.online/mcp
Authentication: Authorization: Bearer sk-... (your ConvertFleet API key).
Transport: Streamable HTTP. Long-running scrapes return a job_id; poll get_job_result.

## google_maps_search — Google Maps Search
Scrape Google Maps business listings (name, address, phone, website, rating, reviews) for a search query and location. Returns B2B leads.
Category: maps. Credit bucket: api (cost 1).
Parameters:
  - query (string, required): What to search for, e.g. 'dentists', 'coffee shops'. Combined with location.
  - location (string, optional): City / area to search in, e.g. 'Miami, FL'.
  - limit (integer, optional) (default 20): Max number of listings to return (clamped to the account tier ceiling).
  - language (string, optional): Optional 2-letter UI language hint, e.g. 'en'.

## facebook_page_scrape — Facebook Page Scraper
Pull public Facebook Page details (about, contact, category) from a page URL or ID.
Category: social. Credit bucket: api (cost 1).
Parameters:
  - page_url_or_id (string, required): Facebook Page URL or numeric/vanity ID.

## facebook_ads_scrape — Facebook Ad Library Search
Search the Facebook Ad Library by keyword/page and country. Returns active or inactive ad creatives.
Category: social. Credit bucket: api (cost 1).
Parameters:
  - query (string, required): Keyword or advertiser/page name to search the Ad Library for.
  - country (string, optional) (default "ALL"): ISO country code to scope ads to, or 'ALL'.
  - ad_type (string, optional) (default "ALL"): Ad category filter (e.g. ALL, POLITICAL_AND_ISSUE_ADS).
  - status (string, optional) [active|inactive|all] (default "active"): Ad delivery status.
  - limit (integer, optional) (default 20): Max ads to return.

## youtube_extract — YouTube Extractor
Extract metadata and stats for a YouTube video OR channel. Pass a video URL for one video, or a channel URL to list recent videos. Auto-detects which.
Category: media. Credit bucket: api (cost 1).
Parameters:
  - url (string, required): A YouTube video URL (watch?v=, youtu.be, /shorts/) or channel URL (/@handle, /channel/, /c/, /user/).
  - max_videos (integer, optional) (default 20): For channel URLs: how many recent videos to list.

## youtube_competitor — YouTube Competitor Analyzer
Compare 1-5 YouTube channels side by side (subscriber counts, upload cadence, recent performance).
Category: media. Credit bucket: api (cost 1).
Parameters:
  - urls (string[], required): 1-5 YouTube channel URLs to compare.
  - max_videos (integer, optional) (default 30): Recent videos to sample per channel.

## youtube_transcript — YouTube Transcript Extractor
Get the transcript / closed captions for one or many YouTube videos. Returns, per video, the full plain-text transcript, timestamped segments, and an .srt subtitle string. Works with manual and auto-generated captions; can target a language or auto-translate.
Category: media. Credit bucket: api (cost 1).
Parameters:
  - urls (string[], required): 1-50 YouTube video URLs (watch?v=, youtu.be, /shorts/) to transcribe.
  - languages (string[], optional): Preferred caption language codes in priority order, e.g. ['en','es']. Defaults to English then any available.
  - prefer_manual (boolean, optional) (default true): Prefer human-written captions, falling back to auto-generated. Set false to prefer auto captions.
  - translate_to (string, optional): Optional target language code to auto-translate the transcript into (e.g. 'en').
  - include_timestamps (boolean, optional) (default true): Include the timestamped segment list and .srt string in each row.

## reddit_scrape — Reddit Scraper
Scrape Reddit posts/comments/communities by keyword search or direct URLs, with sort and time filters.
Category: social. Credit bucket: api (cost 1).
Parameters:
  - mode (string, optional) [search|url] (default "search"): 'search' by keywords, or 'url' to scrape specific post/subreddit URLs.
  - keywords (string[], optional): Search terms (mode=search).
  - urls (string[], optional): Reddit post/subreddit/user URLs (mode=url).
  - sort_by (string, optional) [new|hot|top|relevance] (default "new"): Result ordering.
  - time_range (string, optional) [hour|day|week|month|year|all] (default "all"): Time window for top/relevance.
  - scrape_comments (boolean, optional) (default false): Also pull comments for each post.
  - max_posts (integer, optional) (default 25): Max posts to return.
  - max_comments (integer, optional) (default 10): Max comments per post when scrape_comments=true.

## tiktok_scrape — TikTok Scraper
Scrape TikTok by hashtag, profile/username, search query, or direct video URLs.
Category: social. Credit bucket: api (cost 1).
Parameters:
  - mode (string, optional) [hashtag|profile|search|url] (default "hashtag"): What to scrape.
  - hashtags (string[], optional): Hashtags without '#' (mode=hashtag).
  - usernames (string[], optional): Usernames without '@' (mode=profile).
  - queries (string[], optional): Search queries (mode=search).
  - urls (string[], optional): Direct TikTok video URLs (mode=url).
  - max_videos (integer, optional) (default 20): Max videos to return.

## twitter_scrape — Twitter / X Scraper
Scrape X/Twitter by search query, username, or tweet URLs. Returns tweets with engagement.
Category: social. Credit bucket: api (cost 1).
Parameters:
  - mode (string, optional) [search|profile|url] (default "search"): What to scrape.
  - queries (string[], optional): Search queries (mode=search).
  - usernames (string[], optional): Usernames without '@' (mode=profile).
  - urls (string[], optional): Direct tweet URLs (mode=url).
  - max_tweets (integer, optional) (default 25): Max tweets to return.
  - include_replies (boolean, optional) (default false): Include reply tweets.
  - include_retweets (boolean, optional) (default true): Include retweets.

## instagram_scrape — Instagram Followers Scraper
Scrape an Instagram account's followers or following list. Returns username, full name, user id, verified/private flags and avatar per account. Follower lists need a server-side IG session (IG_SESSIONID); without one it returns the target profile's public metadata only.
Category: social. Credit bucket: api (cost 1).
Parameters:
  - usernames (string[], required): Instagram handles (without '@') or profile URLs, one or more.
  - data_to_scrape (string, optional) [followers|following] (default "followers"): Scrape the account's followers or the accounts it is following.
  - max_results (integer, optional) (default 500): Max results per account (1-50000).

## linkedin_scrape — LinkedIn Scraper
Scrape public LinkedIn company/person profiles by URL, slug, or search query. Optionally enrich with emails.
Category: social. Credit bucket: api (cost 1).
Parameters:
  - urls (string[], optional): Full LinkedIn profile/company URLs.
  - slugs (string[], optional): Profile/company slugs (the part after /in/ or /company/).
  - query (string, optional): Search query to find profiles.
  - max_results (integer, optional) (default 50): Max profiles to return (max 100).
  - do_email (boolean, optional) (default false): Attempt to find associated emails.

## maps_reviews_scrape — Google Maps Reviews Scraper
Scrape reviews for a specific Google Maps place, with sort and minimum-rating filters.
Category: maps. Credit bucket: api (cost 1).
Parameters:
  - place_url (string, required): Google Maps place URL.
  - max_reviews (integer, optional) (default 20): Max reviews to return.
  - sort_by (string, optional) [newest|highest|lowest|relevant] (default "newest"): Review ordering.
  - min_rating (integer, optional) (default 1): Only return reviews at or above this star rating (1-5).

## product_scrape — Product Scraper
Scrape an e-commerce store's product catalogue (WooCommerce, Shopify, or generic) including variations, paid add-ons (each add-on option returns the combined parent+add-on total), descriptions, and reviews. Supports price/category/stock filters.
Category: ecommerce. Credit bucket: api (cost 1).
Parameters:
  - url (string, required): Store homepage or shop URL.
  - max_products (integer, optional) (default 50): Max products (0 = whole catalogue).
  - include_variations (boolean, optional) (default true): Expand variable products into per-variant rows.
  - include_addons (boolean, optional) (default true): Capture paid product add-ons (e.g. a battery bank on a UPS). Each add-on option becomes a row whose price is the combined parent+add-on total.
  - include_descriptions (boolean, optional) (default true): Include product descriptions.
  - include_reviews (boolean, optional) (default true): Include product reviews.
  - max_reviews (integer, optional) (default 20): Max reviews per product.
  - search (string, optional): Filter: only products whose name contains this text.
  - category (string, optional): Filter: only products whose category contains this text.
  - min_price (number, optional): Filter: minimum base price.
  - max_price (number, optional): Filter: maximum price (uses the add-on-inclusive total).
  - in_stock_only (boolean, optional) (default false): Filter: only in-stock products.
  - on_sale_only (boolean, optional) (default false): Filter: only on-sale products.
  - platform (string, optional) [auto|woocommerce|shopify|generic] (default "auto"): Force a platform or auto-detect.

## email_verify — Email Verifier
Verify deliverability of one or many email addresses (syntax, MX, SMTP).
Category: email. Credit bucket: api (cost 1).
Parameters:
  - emails (string[], required): Email addresses to verify (max 100).
  - do_smtp (boolean, optional) (default true): Perform live SMTP mailbox checks.

## disposable_email_check — Disposable Email Checker
Flag disposable / temporary / throwaway email addresses or domains.
Category: email. Credit bucket: api (cost 1).
Parameters:
  - emails (string[], required): Emails or domains to check (max 200).
  - do_mx (boolean, optional) (default true): Also verify the domain has MX records.

## website_email_find — Website Email Finder
Crawl a website/domain and find public contact emails, phones, and social links.
Category: email. Credit bucket: api (cost 1).
Parameters:
  - website (string, required): Website URL or domain to crawl.
  - max_pages (integer, optional) (default 12): Max pages to crawl (clamped to tier ceiling).
  - include_phones (boolean, optional) (default true): Also extract phone numbers.
  - include_socials (boolean, optional) (default true): Also extract social profile links.

## youtube_download — YouTube Downloader
Get downloadable media URLs and available formats/metadata for a YouTube video.
Category: media. Credit bucket: api (cost 1).
Parameters:
  - url (string, required): YouTube video URL.

## instagram_download — Instagram Downloader
Get downloadable media URLs and metadata for an Instagram post or reel.
Category: media. Credit bucket: api (cost 1).
Parameters:
  - url (string, required): Instagram post/reel URL.

## tiktok_download — TikTok Downloader
Get downloadable (watermark-free) media URLs and metadata for a TikTok video.
Category: media. Credit bucket: api (cost 1).
Parameters:
  - url (string, required): TikTok video URL.

## facebook_download — Facebook Downloader
Get downloadable media URLs and metadata for a Facebook video.
Category: media. Credit bucket: api (cost 1).
Parameters:
  - url (string, required): Facebook video URL.

## snapchat_download — Snapchat Downloader
Get downloadable media URLs and metadata for a Snapchat spotlight/story video.
Category: media. Credit bucket: api (cost 1).
Parameters:
  - url (string, required): Snapchat video URL.

Helper tools: get_job_result(job_id, tool_flow), list_jobs(status?).
Last updated: 2026-06-14T00:00:00Z