| name | similarweb-website |
| description | Website traffic analytics from SimilarWeb: overview, traffic engagement, marketing channels, audience geography, referrals, similar sites, search traffic, keywords, social traffic, display advertising, and ad publishers. |
similarweb-website
Website traffic analytics from SimilarWeb: overview, traffic engagement, marketing channels, audience geography, referrals, similar sites, search traffic, keywords, social traffic, display advertising, and ad publishers.
Prerequisites
- Node.js 22+
- Chrome with remote debugging (only for
auth)
- chrome-cdp skill (only for
auth)
- A SimilarWeb Pro account (logged in at pro.similarweb.com)
Setup
Open SimilarWeb Pro in Chrome and log in, then run:
node similarweb-website.mjs auth
This extracts all cookies (including the AWS WAF token required for API access) from your Chrome session.
Usage
node similarweb-website.mjs overview google.com
node similarweb-website.mjs traffic google.com
node similarweb-website.mjs traffic google.com --country=840
node similarweb-website.mjs channels google.com
node similarweb-website.mjs channels google.com --country=840
node similarweb-website.mjs geography google.com
node similarweb-website.mjs geography google.com --count=20
node similarweb-website.mjs referrals google.com
node similarweb-website.mjs referrals google.com --country=840
node similarweb-website.mjs similar google.com
node similarweb-website.mjs similar google.com --count=50
node similarweb-website.mjs search-traffic google.com
node similarweb-website.mjs search-traffic google.com --country=840
node similarweb-website.mjs keywords google.com
node similarweb-website.mjs keywords google.com --country=840
node similarweb-website.mjs social google.com
node similarweb-website.mjs social google.com --country=840
node similarweb-website.mjs display google.com
node similarweb-website.mjs display google.com --country=840
node similarweb-website.mjs ads google.com
node similarweb-website.mjs ads google.com --country=840
Domain input accepts google.com, www.google.com, or full URLs like https://google.com/search.
Country codes: 999 = Worldwide (default), 840 = US, 826 = UK, 276 = Germany, 392 = Japan.
How it works
-
auth -- Uses CDP to extract all cookies from a Chrome tab open to pro.similarweb.com. Stores the full cookie string (including the AWS WAF token and SGTOKEN cookies required for API access).
-
overview -- Calls GET /api/WebsiteOverview/getheader. Returns title, description, category, global ranking, category ranking, monthly visits, year founded, employee range, and highest traffic country.
-
traffic -- Makes 3 parallel widgetApi calls: EngagementOverview/Table for visits/bounce/duration/pages, EngagementDesktopVsMobileVisits/PieChart for device split, and WebRanks/SingleMetric for global/country/category ranks.
-
channels -- Calls widgetApi/MarketingMixTotal/TrafficSourcesOverview/PieChart. Returns per-channel traffic breakdown (Direct, Organic Search, Paid Search, Social, Referrals, Email, Display Ads) with total/desktop/mobile splits.
-
geography -- Calls widgetApi/WebsiteGeographyExtended/GeographyExtended/Table. Returns top countries with traffic share, engagement metrics (pages/visit, duration, bounce rate), and country rank.
-
referrals -- Calls GET /api/websiteanalysis/GetTrafficSourcesTotalReferralsTable. Returns top referring domains with traffic share, visit counts, category, rank, and month-over-month change.
-
similar -- Calls GET /api/WebsiteOverview/getsimilarsites. Returns competing domains with their global rank.
-
search-traffic -- Calls GET /api/searchoverview/overview/traffic. Returns monthly graph data for total search visits, organic visits, and paid visits.
-
keywords -- Makes 3 parallel calls for keyword counts, branded vs non-branded traffic split, and Top 3 vs Rest-to-100 keyword ranking.
-
social -- Calls GET /api/websiteanalysis/GetTrafficSocial. Returns total social volume, per-platform breakdown, and monthly volume trends.
-
display -- Makes 2 parallel calls: AdIntelligence/Advertiser/summary for campaign/creative counts, and AdIntelligence/Advertiser/Campaigns/Data for individual ad campaigns with landing pages and activity dates.
-
ads -- Calls GET /api/AdIntelligence/Advertiser/Publishers/breakdown. Returns ad publisher records with impressions share, visits share, spend share, category, and rank.
Data storage
~/.local/share/showrun/data/similarweb-website/
session.json # Auth cookies
cache/
google_com-overview.json # Cached command outputs
google_com-traffic.json
google_com-channels.json
google_com-geography.json
google_com-referrals.json
google_com-similar.json
google_com-search-traffic.json
google_com-keywords.json
google_com-social.json
google_com-display.json
google_com-ads.json
Session expiry
SimilarWeb sessions last days to weeks. If you get 401/403 errors, re-run:
node similarweb-website.mjs auth
Make sure you have an active SimilarWeb Pro tab open in Chrome when running auth. The AWS WAF token (aws-waf-token) and session cookies (.SGTOKEN.SIMILARWEB.COM, .DEVICETOKEN.SIMILARWEB.COM) are all essential for API access. Every API request also sends custom headers (X-Requested-With, X-Sw-Page, X-Sw-Page-View-Id) to pass AWS WAF protection.