mcpField
S
similarweb-traffic

similarweb-traffic

github.com/openclaudiaMarketing & growth722215 installsUpdated 1w ago
Repository

About similarweb-traffic

A skill for retrieving SimilarWeb traffic estimates for domains. Its Node script reports visit trends, sources, audience locations, keywords, engagement metrics, and ranks in Markdown or JSON.

Key features

  1. 01Monthly visit estimates and trends
  2. 02Traffic-source breakdown
  3. 03Top countries and keywords
  4. 04Engagement metrics and domain ranks
  5. 05Markdown and normalized JSON output

Use cases

  1. 01Checking estimated traffic for a domain
  2. 02Reviewing a site's traffic-source mix
  3. 03Comparing domains or competitors
  4. 04Exporting metrics for further analysis

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/openclaudia/openclaudia-skills --skill similarweb-traffic

After installing, type/similarweb-trafficin Claude Code to confirm it loaded.

Bundled filesscripts/fetch-similarweb-traffic.js

Details

From the project README

SimilarWeb Traffic

Fetch traffic-overview estimates for any domain — monthly visits, traffic-source breakdown, top countries, top keywords, engagement metrics, and global/category ranks.

When to Use This Skill

Use this skill when the user:

  • Asks how much traffic a domain gets ("what's the traffic for X")
  • Wants monthly visit trends for a site
  • Needs a traffic-source breakdown (organic vs direct vs paid vs GenAI, etc.)
  • Wants to know a site's audience countries
  • Wants to compare/benchmark several domains against each other or competitors

Usage

No API key required. Self-contained Node script (uses built-in fetch, no npm install).

node scripts/fetch-similarweb-traffic.js <domain>

Examples:

# Formatted markdown summary (default)
node scripts/fetch-similarweb-traffic.js chatslide.ai

# Raw normalized JSON (for further processing / comparisons)
node scripts/fetch-similarweb-traffic.js stripe.com --json

The domain can be passed bare (example.com) or as a URL (https://www.example.com/pricing) — it gets normalized (strips scheme, www., and path).

Comparing multiple domains

Run the script once per domain with --json and combine the results into a table. Add a short delay between calls to be polite to the endpoint.

Output

Default mode prints a markdown summary: a metrics table (monthly visits, ranks, bounce, pages/visit, time on site), a monthly-visits trend line, traffic-source breakdown, top countries, and top keywords.

--json mode prints a normalized object:

{
  "domain": "stripe.com",
  "globalRank": 327,
  "categoryRank": 21,
  "category": "Finance",
  "snapshotMonth": "2026-05",
  "visits": 122394040,
  "bounceRate": 0.55,
  "pagesPerVisit": 3.26,
  "timeOnSite": 165.9,
  "estimatedMonthlyVisits": [{ "date": "2026-03-01", "visits": 118067753 }],
  "trafficSources": { "searchOrganic": 0.48, "direct": 0.23, "...": 0 },
  "topCountries": [{ "countryCode": "US", "value": 0.087 }],
  "topKeywords": ["..."]
}

visits is the most recent complete month. Rates (bounceRate, all trafficSources, topCountries[].value) are 0–1 fractions.

API Details

  • Endpoint: https://data.similarweb.com/api/v1/data?domain=<domain> — SimilarWeb's undocumented public data endpoint (the one their browser extension uses). No auth, no key, free.
  • Requires a browser user-agent header (the script sends one) — default curl/bot agents are blocked.
  • Synchronous, returns immediately.

Important Notes

  • Estimates, not ground truth. SimilarWeb models traffic; numbers can be off, especially for mid/low-traffic sites. For a domain you own, your own Google Analytics / Search Console data is authoritative — prefer those when available.
  • Unknown domains return zeros, not an error. SimilarWeb responds HTTP 200 with all-zero/synthetic data when it has no data for a domain. If every visit count is 0, treat it as "no SimilarWeb data."
  • Unofficial endpoint. It can be rate-limited, change shape, or require auth without notice; this is a gray-area use of SimilarWeb's data outside their paid API.
  • Exit codes: 2 network error, 3 non-200 HTTP response.

Comments

Markdown supported