Marketing Data & Context for Claude
How to connect and start pulling live marketing data directly into Claude.
Marketing Data & Context for Claude connects as an MCP (Model Context Protocol) server. Once connected, Claude can pull live data from Instagram, TikTok, YouTube, Google Maps, Amazon, Google Play, Apple App Store, Meta Ads Library, Google Ads Library, Google Keyword Planner, Google Analytics 4, Google Search Console, Google Ads (your account), and Meta Ads (your account) on demand. No copy-pasting, no exports.
Click here to sign up - you get 30 free credits instantly, no credit card required.
Follow the instructions below.
Just describe what you need in plain English - Claude handles the rest.
Connect via Claude.ai (Pro and Team plans) - once connected, it also works automatically in Claude Code and Claude Desktop.
Smacienthttps://claude.smacient.com/mcpnpm install -g @smacient/mcp && smacient-mcp setupclaude "List my GA4 properties"
GA4 and Google Search Console tools require a separate one-time Google account connection. This gives Claude read-only access to your own Analytics and Search Console properties.
Sign in at smacient.com/mde/dashboard/ and scroll to the Connected Accounts section.
You will be redirected to Google's consent screen. GA4 and Search Console share a single Google OAuth connection, so connecting once gives you access to both.
After connecting, the tools become available immediately. Ask Claude to list your properties to confirm the connection is working.
Google Ads tools give Claude read-only access to your Google Ads accounts - including campaign performance, search terms, spend, ROAS, video campaigns, and Performance Max. All Google Ads tools are free to use.
Sign in at smacient.com/mde/dashboard/ and scroll to the Connected Accounts section.
You will be redirected to Google's consent screen. We request read-only access to your Google Ads data. We never request permission to create, edit, or delete any campaigns, ads, or budgets.
gads_list_accounts
Always start by asking Claude to list your Google Ads accounts. This returns the customer_id and (if applicable) login_customer_id needed for all other Google Ads tools.
If your Google account manages multiple client accounts through a Manager Account (MCC), gads_list_accounts will automatically detect this and return a login_customer_id alongside each sub-account's customer_id. When querying a sub-account, always pass both values to the tool.
login_customer_id. The gads_list_accounts tool returns this automatically - just ask Claude to list your accounts first and it will handle the rest.
We request the minimum Google Ads OAuth scopes needed - adwords read-only access. This allows reading campaign data, metrics, and search terms. We never request permission to create, modify, or delete any ads, campaigns, budgets, or account settings.
Meta Ads tools give Claude read-only access to your Facebook and Instagram ad accounts - including spend, ROAS, campaign performance, audience breakdowns, and creative analysis. Connection takes under a minute.
Sign in at smacient.com/mde/dashboard/ and scroll to the Connected Accounts section.
You will be redirected to Facebook's consent screen. We only request ads_read permission - read-only access to your ad performance data. We never request permission to create or modify your ads.
After connecting, all Meta Ads tools are available immediately. Start by asking Claude to list your ad accounts to confirm the connection is working.
We request only ads_read, which allows reading your ad performance data. We never request permission to create, edit, or delete any ads or campaigns. Your credentials are stored securely and never shared with third parties.
To disconnect, go to your dashboard and click Disconnect on the Meta Ads card. You can also revoke access directly from Facebook:
You are always in control of which accounts are connected. You can disconnect any connected account at any time directly from your dashboard.
Sign in at smacient.com/mde/dashboard/ and scroll to the Connected Accounts section.
The button will ask you to confirm - click it once more to proceed. This two-step process prevents accidental disconnects.
Your stored credentials are deleted from our database right away. Claude will no longer be able to access that account's data.
You can also revoke Google access independently of our dashboard - useful if you have lost access to your Smacient account.
Revoking from Google's side stops our tools from accessing your data immediately, but the stored tokens in our system will remain until you also disconnect from your dashboard or they naturally expire.
Once connected, Claude has access to 47 tools across 14 platforms:
extract_instagram_posts
Extract recent posts from one or more Instagram profiles by exact username. Returns captions, likes, comments, video URLs, carousel images, and timestamps. Use this when you already know the username.
search_instagram
Search Instagram to discover profiles, hashtags, or places. Returns account metadata (follower counts, bios) - not post content. Use this to find a username, then use extract_instagram_posts to get their posts.
extract_tiktok_videos
Extract recent videos from a TikTok profile. Returns views, likes, shares, comments, and captions.
search_tiktok
Search TikTok by keyword and return matching videos with engagement data.
get_youtube_channel
Get channel stats: subscribers, total views, video count, and description. Accepts channel handle, URL, or ID.
get_youtube_videos
Get recent videos from a channel with views, likes, comments, and duration. Optionally include or exclude Shorts.
get_youtube_comments
Fetch top comments from a YouTube video. Sort by relevance or newest first. Useful for audience sentiment and feedback analysis.
search_google_maps
Search for businesses or places by name, optionally filtered by city. Returns ratings, addresses, and a data_id to pass to the reviews tool.
extract_google_maps_reviews
Extract reviews for a specific Google Maps listing using a data_id from the search tool or a Maps URL. Sort by newest, highest, lowest, or most relevant.
amazon_get_reviews
Extract customer reviews for one or more Amazon products by ASIN or product URL. Returns reviewer name, rating, title, review text, verified purchase status, and helpful votes. Filter by star rating or keyword. Supports any Amazon marketplace (US, UK, IN, DE, CA, AU, FR).
search_google_play
Search the Google Play Store for apps by keyword and country. Returns app names, IDs, ratings, install counts, pricing, and developer info.
get_google_play_reviews
Extract user reviews for one or more Google Play apps. Returns reviewer name, rating, review text, developer reply, app version, and helpful votes. Accepts App IDs (com.xxx) or Play Store URLs.
get_google_play_app_details
Get detailed information for one or more Google Play apps - ratings, installs, pricing, description, developer info, content rating, and recent changes. Accepts App IDs or Play Store URLs.
get_google_play_similar
Find apps similar to a given Google Play app. Useful for competitive landscape mapping and identifying alternative products in a category.
search_app_store
Search the Apple App Store for apps by keyword and country. Returns app names, IDs, ratings, pricing, genre, and developer info.
get_app_store_details
Get detailed information for one or more App Store apps - ratings, pricing, description, version history, file size, and supported languages. Accepts numeric App IDs or App Store URLs.
get_app_store_reviews
Extract user reviews for one or more App Store apps. Returns title, review text, rating, author, app version, and helpfulness votes. Sort by most recent or most helpful.
search_meta_ads
Search the Meta Ads Library for any brand's active or historical ads on Facebook and Instagram. Returns ad copy, creative details, and run dates. No account connection required - works for any brand. Provide a brand name or a direct Facebook page URL.
These tools search any brand's public ads on Google's Ads Transparency Center. No account connection required. They are completely separate from the Google Ads tools below which connect to your own account.
find_google_advertiser
Search for any brand in Google's public ads database by name or domain. Returns a list of matching advertisers with their unique advertiser ID, registered country, approximate ad count, and verified status. Always run this first before fetching ads - use the advertiser ID returned here as the input for get_google_ads.
get_google_ads
Fetch the actual ads for a known advertiser using their ID from find_google_advertiser. Returns structured records for each ad creative with format, status, how long it has been running, decoded ad copy, and thumbnails. Filter by region, date range, format (text, image, video), and active status only.
meta_list_accounts
List all Meta Ads accounts your connected Facebook account has access to. Returns account IDs, names, currency, status, and total spend. Always run this first to find the account ID needed for other Meta Ads tools.
meta_get_account_summary
Get overall performance for a date range - total spend, ROAS, CTR, CPC, CPM, reach, purchases, and revenue.
meta_analyze_campaigns
Campaign-level performance breakdown sorted by spend. Includes ROAS per campaign and recommendations on which to scale or pause.
meta_audience_breakdown
Break down ad performance by age, gender, country, device, or publisher platform.
meta_placement_performance
Compare performance across Facebook Feed, Instagram Feed, Reels, Stories, Audience Network, and Messenger placements.
meta_conversion_funnel
Analyse the full funnel from impressions to clicks to view content to add to cart to purchases. Shows drop-off rates at each stage.
meta_creative_analysis
Ad-level performance to identify winning creatives - CTR, ROAS, and purchases per individual ad.
meta_budget_optimization
Categorises campaigns into: scale up (ROAS > 3), maintain (ROAS 1.5 to 3), reduce (ROAS < 1.5), or pause (zero conversions).
gads_list_accounts first to get the customer_id and login_customer_id needed for other tools.
gads_list_accounts
List all Google Ads accounts your connected Google account has access to. Returns account IDs, names, currency, timezone, and status. For Manager (MCC) accounts, also returns the login_customer_id needed to query sub-accounts. Always run this first.
gads_get_account_overview
Get overall account performance - total spend, clicks, impressions, conversions, ROAS, average CPC, and cost per conversion for a date range.
gads_get_campaign_performance
Campaign-level performance breakdown sorted by spend - spend, clicks, impressions, conversions, ROAS, and cost per conversion per campaign.
gads_get_search_terms
Analyse search queries that triggered your ads. Returns performance per search term and automatically flags high performers to add as keywords and wasted spend terms to add as negatives.
gads_get_video_campaigns
Get performance for YouTube and video campaigns - views, view rate, cost per view, and completion rates (25%, 50%, 75%, 100% quartiles).
gads_get_pmax_performance
Get metrics for Performance Max campaigns - spend, conversions, ROAS, and recommendations on which PMax campaigns to scale or review.
gads_run_gaql_query
Execute a custom GAQL (Google Ads Query Language) SELECT query for advanced analysis not covered by the other tools. Read-only - write operations are blocked.
get_keyword_ideas
Generate keyword ideas from a seed keyword or URL. Returns search volume, competition level, and bid range estimates for each keyword.
get_historical_keyword_data
Fetch up to 24 months of monthly search volume history for one or more keywords. Useful for spotting seasonal trends and long-term demand shifts.
ga4_list_properties
List all GA4 accounts and properties connected to your Google account. Use this to find the property ID needed for other GA4 tools.
ga4_get_report
Run a custom GA4 report for any property. Specify dimensions (e.g. page, country, device), metrics (e.g. sessions, users, conversions), and a date range.
ga4_get_realtime
Get real-time active users and top pages or sources for a GA4 property right now.
ga4_compare_periods
Compare two date periods side by side for any GA4 property. Returns metrics for both periods with absolute and percentage change.
gsc_list_sites
List all verified sites in your Google Search Console account.
gsc_query_analytics
Query search analytics for a site. Returns clicks, impressions, CTR, and average position for any date range and dimension (query, page, country, device).
gsc_top_pages
Get the top performing pages from Search Console ranked by clicks for a given date range.
gsc_compare_periods
Compare two time periods of organic search performance. Useful for spotting traffic shifts after content updates or algorithm changes.
gsc_find_opportunities
Find keywords with high impressions but low CTR - pages that rank but do not get clicks. Filter by minimum impressions and maximum CTR thresholds.
get_credits_balance
Check your current credit balance and plan. Free to call.
Credits are deducted per tool call based on the volume of data returned. GA4, Search Console, Google Ads, and Meta Ads (your account) tools are always free.
| Tool | Credit Cost |
|---|---|
| Social & Web | |
extract_instagram_posts | 1 per 3 posts returned |
search_instagram | 1 per 3 results returned |
extract_tiktok_videos | 2 per video returned |
search_tiktok | 2 per video returned |
get_youtube_channel | 1 per channel |
get_youtube_videos | 2 to 3 per call (tiered by count) |
get_youtube_comments | 2 to 3 per call (tiered by count) |
search_google_maps | 1 per call |
extract_google_maps_reviews | 1 per 30 reviews returned |
| Amazon | |
amazon_get_reviews | 1 per 10 reviews returned |
| Google Play Store | |
search_google_play | 1 per 50 results returned |
get_google_play_reviews | 1 per 50 reviews returned |
get_google_play_app_details | 1 per app returned |
get_google_play_similar | 1 per input app |
| Apple App Store | |
search_app_store | 1 per 10 results returned |
get_app_store_details | 1 per app returned |
get_app_store_reviews | 1 per 10 reviews returned |
| Ad Libraries (no account required) | |
search_meta_ads | 1 (brand lookup) + 1 per 10 ads returned |
find_google_advertiser | Varies by tool configuration |
get_google_ads | Varies by tool configuration |
| Keyword Research | |
get_keyword_ideas | 5 credits per call |
get_historical_keyword_data | 10 credits per call |
| Google Ads - Your Account | |
gads_list_accounts | Free |
gads_get_account_overview | Free |
gads_get_campaign_performance | Free |
gads_get_search_terms | Free |
gads_get_video_campaigns | Free |
gads_get_pmax_performance | Free |
gads_run_gaql_query | Free |
| Meta Ads - Your Account | |
meta_list_accounts | Free |
meta_get_account_summary | Free |
meta_analyze_campaigns | Free |
meta_audience_breakdown | Free |
meta_placement_performance | Free |
meta_conversion_funnel | Free |
meta_creative_analysis | Free |
meta_budget_optimization | Free |
| Google Analytics 4 | |
ga4_list_properties | Free |
ga4_get_report | Free |
ga4_get_realtime | Free |
ga4_compare_periods | Free |
| Google Search Console | |
gsc_list_sites | Free |
gsc_query_analytics | Free |
gsc_top_pages | Free |
gsc_compare_periods | Free |
gsc_find_opportunities | Free |
| Account | |
get_credits_balance | Free |
Just ask Claude naturally. Here are some examples to get you started:
"Extract the last 10 posts from @nike and summarise what content themes are performing best."
"Search TikTok for 'skincare routine' videos and identify the top hooks being used."
"Get the latest 20 videos from the MrBeast YouTube channel and tell me which topics get the most views."
"Find coffee shops in Bangalore on Google Maps and pull their reviews - I want to know the most common complaints."
"Get the top 50 Amazon reviews for product B08C1W5N87 and tell me what customers love and what they keep complaining about."
"Search Google Play for 'expense tracker' apps in India and show me the top results with ratings and installs."
"Get the App Store reviews for com.instagram.android and tell me what users are complaining about most this month."
"Find apps similar to Swiggy on Google Play and give me a competitive overview."
"Show me the Meta ads that Coca-Cola has been running and analyse their messaging strategy."
"Find Tanishq on the Google Ads Library and show me what ad creatives they are running right now."
"Search for Nalli on the Google Ads Library - there may be multiple advertisers, show me the options first."
"Get keyword ideas for 'content marketing' in the United States and sort by search volume."
"Run a GA4 report showing sessions and users by page for the last 30 days."
"Compare my GA4 traffic for this month vs last month and highlight what has changed."
"Find my Search Console keywords with more than 500 impressions but less than 3% CTR - these are my quick win opportunities."
"List my Meta Ads accounts and show me overall spend and ROAS for the last 30 days."
"Break down my Meta Ads performance by age and gender - which demographic is converting best?"
"List my Google Ads accounts."
"Get my Google Ads campaign performance for the last month and tell me which campaigns have the best and worst ROAS."
"Pull my Google Ads search terms for the last 30 days and tell me which terms are spending with zero conversions."
"Show me my Performance Max campaign results and which ones I should scale or review."