AdLibrarySpy

MCP serverEverything else

Shopify store and ad intelligence: traffic, best sellers, apps, live Meta ads and weekly breakouts.

Available today. Use it from your connected AI after setup.

Add ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.

Then ask your AI: use AdLibrarySpy

Install AdLibrarySpy

The server’s own address, for the clients that take one directly. Or connect ahel onceand every client you use reads it from one address, with the account kept on ahel rather than in each client’s config.

  • Claude Code

    claude mcp add --transport http --scope user adlibraryspy 'https://adlibraryspy.com/api/mcp'

    Run it once in your project, then open /mcp to approve any sign-in the server asks for.

  • Claude Desktop

    https://adlibraryspy.com/api/mcp

    Add a custom connector in Settings, paste this address, and approve the sign-in.

  • Cursor

    cursor://anysphere.cursor-deeplink/mcp/install?name=adlibraryspy&config=eyJ1cmwiOiJodHRwczovL2FkbGlicmFyeXNweS5jb20vYXBpL21jcCJ9

    Open the link and Cursor adds the server at that address.

  • ChatGPT

    https://adlibraryspy.com/api/mcp

    In Settings, enable Developer mode, create an MCP app, and paste this address. Your plan and workspace must allow custom apps.

  • Codex

    codex mcp add adlibraryspy --url 'https://adlibraryspy.com/api/mcp'

    Run it once, then sign in with codex mcp login adlibraryspy if the server asks for an account.

From the project's README

As published by PSA-Team-source/AdLibrarySpy in README.md.

100% free Shopify store and Meta ads intelligence, built for the community.

Find the stores that are winning, see the ads they run, and track your competitors. Every number comes from a real measurement with its source attached. Nothing is estimated.

Open the app → · Run it yourself · Use it from Claude or ChatGPT · This week's breakouts

What it is

AdLibrarySpy indexes 14.7M online stores, 3.9M of them on Shopify (as of September 2026), and the Meta ads they run. It shows you which stores are growing, what they sell and how they advertise. Traffic figures come from SimilarWeb's measurement of each store's exact domain, labelled with the month they cover. Ad data comes from the Meta Ad Library.

It's free: there are no plans, no credit limits and no checkout. It's also open source under MIT, and this repository is the code that runs adlibraryspy.com.

Features

Shops: find the stores that are winning

  • Filter by platform (Shopify, WooCommerce, Shopline, Shoplazza and others), category, traffic, traffic growth, product count, store origin, visitor country, creation date, technology and pixels
  • SimilarWeb visits and month-over-month growth for the exact store, with a trend line
  • AOV, live Meta ads, 7-day ad peak, top products and launch year on every row
  • Hide stores you've already seen, and save stores to shared folders

Ads: the creative library

  • Search ad copy, brands and landing pages, then filter by creation date, media type, format, placement, country and niche
  • Run dates and placements for each ad, with video playback in the grid
  • AI creative labels: hook, angle, funnel stage, offer and urgency, each with the model's confidence
  • Save ads to folders and share them with your team. The Advertisers screen ranks brands by creative count

Store dossier: everything about one store

  • Monthly visits and traffic over time, plus visitor countries
  • Live Meta ads over time, with a link to the store's ads
  • Product count, best sellers and latest products, the theme, currency and locale
  • The pixels and apps the store runs, and similar shops

Brandtracker: watch your competitors

  • Track any store. A snapshot of its traffic, live ads and new ads is recorded every day
  • See what changed across 1, 7, 14 and 30 days, and organise tracked stores in folders

Trends and the Monday report

  • Trends: niches, stores and products whose measured traffic is breaking out
  • The weekly report: stores scaling their ads, the fastest traffic growth, ad peaks and the newest winners, published every Monday at /weekly and sent by email if you opt in
  • Public, shareable pages for every store (/store/{domain}), a store directory by niche, country and tech, and /trending

Ask your AI

A built-in MCP server (OAuth 2.1) lets Claude, ChatGPT and other assistants search shops and ads, open dossiers and manage your brandtracker with your workspace's access. In Claude, go to Settings → Connectors → Add custom connector and paste https://adlibraryspy.com/api/mcp. All clients and tools →

Teams, API and extension

  • Free team workspaces with roles, invites, shared saves and an activity log. Sign-in is passwordless (magic links)
  • API keys for the MCP endpoint (Settings → API)
  • A Chrome extension that shows any Shopify store's traffic, ads, products and apps in one click

Why trust the numbers

  • A figure appears only if something measured it, and it carries its source and period, for example SimilarWeb · Aug 2026. Traffic history shows only real months, and a chart needs two real data points to be drawn at all.
  • A missing value is shown as nothing, never as 0, a dash or a guess.
  • AI labels are marked as model judgments, with a confidence. When a label is missing, the model wasn't sure.

The full rules are in docs/data-honesty.md.

This week's Shopify breakouts

Updated every week by a GitHub Action from the public weekly report.

Week 39, 2026 · updated 2026-09-25 · full week · all weeks

Top scaling stores

Stores adding the most ads in the Meta Ad Library, with measured traffic behind them. Source: Change in running ads in the Meta Ad Library, AdLibrarySpy index (Sep 2026 snapshot). Traffic: SimilarWeb, Aug 2026.

#StoreNicheChangeMeasured
1SM ApplianceHome & Garden🇵🇭+251 ads344 ads running in the Meta Ad Library (+69%) · 309K visits in Aug 2026 (SimilarWeb)
2Power CrunchHealth🇺🇸+115 ads114 ads running in the Meta Ad Library · 33K visits in Aug 2026 (SimilarWeb)
3Roosty'sFood & Drink🇺🇸+78 ads99 ads running in the Meta Ad Library (+49%) · 110K visits in Aug 2026 (SimilarWeb)
4Official EA SiteGames🇺🇸+68 ads137 ads running in the Meta Ad Library · 77M visits in Aug 2026 (SimilarWeb)
5AntiSocialSocialClubApparel🇺🇸+68 ads154 ads running in the Meta Ad Library (+425%) · 183K visits in Aug 2026 (SimilarWeb)
6Official Sun Bum® WebsiteBeauty & Fitness🇺🇸+66 ads253 ads running in the Meta Ad Library · 201K visits in Aug 2026 (SimilarWeb)
7KardiaHealth+61 ads151 ads running in the Meta Ad Library (+203%) · 172K visits in Aug 2026 (SimilarWeb)
8MeUndies®Apparel🇺🇸+60 ads541 ads running in the Meta Ad Library (+35%) · 1.8M visits in Aug 2026 (SimilarWeb)
9SYLVOXConsumer Electronics🇺🇸+57 ads109 ads running in the Meta Ad Library (+172%) · 185K visits in Aug 2026 (SimilarWeb)
10LSKDApparel🇦🇺+44 ads69 ads running in the Meta Ad Library (+733%) · 2M visits in Aug 2026 (SimilarWeb)

Fastest traffic growth

Largest month-over-month jump in measured visits, among stores that already had 20K+ visits. Source: SimilarWeb measured visits, Jul 2026 → Aug 2026.

#StoreNicheChangeMeasured
1StancedCoApparel🇺🇸+1,522%29K → 474K visits, Jul 2026 → Aug 2026 (SimilarWeb)
2StarliteComputers🇬🇭+1,519%85K → 1.4M visits, Jul 2026 → Aug 2026 (SimilarWeb)
3Starlink OnlineComputers🇶🇦+1,503%55K → 883K visits, Jul 2026 → Aug 2026 (SimilarWeb)
4Absolute EclipseApparel🇱🇻+1,475%77K → 1.2M visits, Jul 2026 → Aug 2026 (SimilarWeb)
5CompuGhanaHome & Garden🇬🇭+1,410%85K → 1.3M visits, Jul 2026 → Aug 2026 (SimilarWeb)
6Solar Eclipse EyewearHealth🇺🇸+1,399%52K → 784K visits, Jul 2026 → Aug 2026 (SimilarWeb)
7Deli HempFood & Drink🇫🇷+1,204%29K → 373K visits, Jul 2026 → Aug 2026 (SimilarWeb)
8Primal StormHealth🇺🇸+1,014%59K → 659K visits, Jul 2026 → Aug 2026 (SimilarWeb)
9DogshoodPets & Animals🇩🇪+981%36K → 385K visits, Jul 2026 → Aug 2026 (SimilarWeb)
10RADER SHOPFood & Drink🇯🇵+967%22K → 236K visits, Jul 2026 → Aug 2026 (SimilarWeb)

Run it yourself

git clone https://github.com/PSA-Team-source/AdLibrarySpy && cd AdLibrarySpy
npm install                    # Node 22.18+
cp .env.example .env.local     # set DATABASE_URL (PGSSL=off for a local Postgres) and SMTP_*
npm run migrate
npm run dev                    # http://localhost:4311
npm test && npm run typecheck

SMTP is required because every sign-in is a link sent by email. A local mail catcher such as Mailpit works (SMTP_HOST=localhost, SMTP_PORT=1025).

Where the data comes from: accounts, workspaces, the brandtracker, saves, API keys, OAuth and the public pages all run on your own Postgres. Store and ad data come from the AdLibrarySpy market index, a hosted service this app is a client of. Its shop endpoints are public, so a local instance shows stores out of the box. Ad creatives need a service account (PLATFORM_JWT_SECRET, MARKET_SERVICE_ACCOUNT_ID). Without one, the ads screens stay empty rather than inventing anything. To run your own instance against the full index, open an issue.

Configuration

All variables are listed, with placeholders, in .env.example.

VariableRequiredEffect when unset
DATABASE_URLyesApp cannot start; /api/health returns 503
PGSSLnoTLS on; set off for a local Postgres without TLS
PG_POOL_MAXnoDefaults to 10 connections
SMTP_HOST, SMTP_PORT, SMTP_USER, SMTP_PASSWORD, SMTP_FROM_EMAIL, SMTP_FROM_NAMEyesSign-in is an emailed magic link: nobody can sign in, and invites cannot send
APP_BASE_URLyes in productionLinks in mail and OAuth metadata point at http://localhost:4311
SESSION_SECRETfor the newsletterAt least 16 characters; without it unsubscribe links cannot be signed
MARKET_API_BASEnoDefaults to the public index, https://api.platformdtc.com/api/v1
MARKET_TIMEOUT_MSnoDefaults to 12000
PLATFORM_JWT_SECRET, MARKET_SERVICE_ACCOUNT_ID, MARKET_SERVICE_EMAILfor ad creatives and MCPService account issued by the index operator; without it ad creatives return empty (shops still work)
CLICKHOUSE_URL, CLICKHOUSE_USER, CLICKHOUSE_PASSWORDnoFunnel events are not recorded
TRAFFIC_PROVIDER + SIMILARWEB_API_KEY / SEMRUSH_API_KEY, TRAFFIC_CACHE_DAYSnoTraffic comes only from the index's SimilarWeb crawl (see architecture)
NEXT_PUBLIC_CHROME_EXTENSION_URLnoThe homepage shows no extension link
APP_VERSIONno/api/health reports dev
WEEKLY_MAIL_PER_SECnoWeekly report sends 4 emails per second

Tech stack

Next.js 15 (App Router, server actions) · React 19 · TypeScript · Tailwind · Radix UI and shadcn/ui · TanStack Query · PostgreSQL · ClickHouse (optional funnel analytics) · Cloudflare edge cache. Multi-tenancy is enforced in lib/auth/guard.ts: a workspace_id always comes from the session, never from the request. See docs/architecture.md for the layout, the traffic model, the AI labels and the MCP server.

Also in this repo

extension/The Chrome extension (Manifest V3, activeTab only, nothing runs in the background).
packages/shopify-inspectnpx shopify-inspect <store>: reads any Shopify store's theme, best sellers, newest products, prices, apps and pixels from its own storefront, from your terminal. Zero dependencies.
packages/mcpadlibraryspy-mcp: a local (stdio) MCP server for Claude Code, Cursor and VS Code, with three tools that need no account.
leaderboard/The Action behind the weekly table above.

Contributing

Issues and pull requests are welcome. See CONTRIBUTING.md and our Code of Conduct. Questions and ideas go to Discussions. Adding app and pixel signatures to shopify-inspect is an easy first contribution. If AdLibrarySpy helps you, a ⭐ helps other people find it.

Star history

License

MIT. The AdLibrarySpy name and logo, third-party logos and the screenshots are not covered. See NOTICE.md.

Advanced
Delivery
adlibraryspy MCP server → your ahel connector (mcp.ahel.ai) → your AI.
Catalog kind
mcp-server
Key
io-github-psa-team-source-adlibraryspy
Source
github.com/PSA-Team-source/AdLibrarySpy
Hosted endpoint
https://adlibraryspy.com/api/mcp