Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words Sign in

SEO and Keyword Data API

✓ keywords.duoleads.com

by hiesemversion 1.2.0i★ 0iRuns in the cloudOfficial site ↗
Registry namecom.duoleads.keywords/keyword-search-volume-google-trends

How to install

What it does

SEO data: keyword volume, CPC, Trends, backlinks, domains, SERP, Maps, audits. Pay per call (x402)

  • Connects Runs in the cloud
  • Account or key No key needed
  • Category Marketing & social media

Use together with

Skills that teach the AI this kind of work; they work alongside this one

scroll-world

A skill that turn any brand into a scrollable 3D world landing page

by oso95★ 11,0651 skills

Skill · How-to guide

social-auto-upload

自动化上传视频到社交媒体:抖音、小红书、视频号、tiktok、youtube、bilibili

by dreammis★ 16,698 (whole repo)4 skills

Skill · How-to guide

native-subtitle-quote-image

保留视频内嵌字幕,精确取帧并生成 3:4 社交长图的 Agent Skill

by chengyi-ai★ 2,8911 skills

Skill · How-to guide

Why it ranks here

This one is in the “Apps that connect to AI” tab, which is ordered without stars, in this order

1. In Claude’s connector directoryNo
2. Tried by our teamNo
3. Works for Thai usersNo
4. Usage without stars20/100Popularity 0 · Freshness 12 · Still answering 8 · Likes from users +0
5. Listed on2026-11-09

Likes from users: 0 · Adds at most 5 points to the order (1 per person). It cannot be bought.

Quality: Passed 4/5 basic checks (shown, not used for ordering)

Install

Pick the AI app you use, then copy the settings.

Let your AI install it with one sentence

Please install SEO and Keyword Data API. Follow https://mcp.popnx.com/i/duoleads-keywords-keyword-search-volume-google-trends.md, show me the commands and wait for my OK before running them.

Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads

Passed 4/5 checks · What you ask goes through the maker’s server (keywords.duoleads.com) · ✓ Commands checked Nov 20, 2026

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude · about 2 min

No key, nothing to install · Set it up once on claude.ai or the desktop app, then use it in chat · free accounts can add 1 · on Team/Enterprise an Owner adds it

  1. Open Claude’s Connectors page

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Click “Add” → “Custom” → “Web” and fill in these 2 fields

    Copy each value into the field with the same name in Claude, then click Continue

    Name · NameSEO and Keyword Data API
    Remote MCP server URL · Addresshttps://keywords.duoleads.com/mcp

    Click Continue past the sign-in settings Claude detected · under Authentication choose what the maker says (Sign in now, Sign in when needed or No sign in), then click Add

  3. Turn it on in a chat

    +ConnectorsSEO and Keyword Data API

  4. Try it

    Use SEO and Keyword Data API and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using SEO and Keyword Data API or shows a SEO and Keyword Data API tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with ChatGPT, depending on your plan

Full MCP: ChatGPT Business, Enterprise or Edu on the web · Pro: connects with read/fetch permissions, so tools that change data may not work · Plus: not confirmed in OpenAI’s docs; if you see an add-custom-MCP option on the Plugins page you can try these steps · web only

  1. Open ChatGPT’s add-MCP page on the web

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Fill in the name and address

    Enter a name, paste the address under Connection, tick the risk warning and click Create as a plugin

    Name · NameSEO and Keyword Data API
    Connection · Addresshttps://keywords.duoleads.com/mcp
  3. Pick SEO and Keyword Data API in a chat

    Start a new chat and pick SEO and Keyword Data API from your plugins before typing

  4. Try it

    Use SEO and Keyword Data API and tell me what you can do for me, then show me one thing

    ✓ If ChatGPT says it is using SEO and Keyword Data API or shows a SEO and Keyword Data API tool in the answer, you are connected

Menu names checked against OpenAI’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Claude Code · about 2 min

No key, nothing to install

  1. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: open PowerShell

  2. Paste this command and press Enter

    claude mcp add --transport http --scope user keyword-search-volume-google-trends https://keywords.duoleads.com/mcp
  3. Type /mcp in Claude Code

    You should see SEO and Keyword Data API listed as connected

  4. Try it

    Use SEO and Keyword Data API and tell me what you can do for me, then show me one thing

    ✓ If Claude Code says it is using SEO and Keyword Data API or shows a SEO and Keyword Data API tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor · about 2 min

No key, nothing to install

  1. Click this button to open Cursor

    Open in Cursor

    Cursor asks you to confirm; click Install

  2. Open the AI chat in Cursor in Agent mode

  3. Try it

    Use SEO and Keyword Data API and tell me what you can do for me, then show me one thing

    ✓ If Cursor says it is using SEO and Keyword Data API or shows a SEO and Keyword Data API tool in the answer, you are connected

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code · about 2 min

No key, nothing to install

  1. Click this button to open VS Code

    Open in VS Code

    VS Code asks you to confirm; click Install

  2. Open the AI chat in VS Code in Agent mode

  3. Try it

    Use SEO and Keyword Data API and tell me what you can do for me, then show me one thing

    ✓ If VS Code says it is using SEO and Keyword Data API or shows a SEO and Keyword Data API tool in the answer, you are connected

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

Address for apps that connect over the web

Addresshttps://keywords.duoleads.com/mcp

JSON settings are under “For developers” below

Stuck? Ask people who use SEO and Keyword Data API💬 Discussion →
For developers: Terminal commands and JSON settings

Over the web

Claude Code

claude mcp add --transport http --scope user keyword-search-volume-google-trends https://keywords.duoleads.com/mcp

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "keyword-search-volume-google-trends": {
      "url": "https://keywords.duoleads.com/mcp"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "keyword-search-volume-google-trends": {
      "type": "http",
      "url": "https://keywords.duoleads.com/mcp"
    }
  }
}

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

Downloads per weeki
Not on npm/PyPI
Verified domain
✓ keywords.duoleads.com
Connection
Runs in the cloud
Transport
streamable-http
Latest versioni
1.2.0
Published to registryi
Nov 10, 2026
Code last changedi
Nov 11, 2026
Last checked
Nov 15, 2026
Maker
hiesem
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Connect over the internet in

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

All apps, with pros and cons →

Related guides

What it can do

Tool names and descriptions exactly as the server reported them on Nov 15, 2026. The maker wrote them, not us; we show them as plain text.

  • keyword_overview

    Search volume, CPC, competition, keyword difficulty and search intent for up to 100 keywords in one $0.04 call (Google Ads data). Use when you already have a keyword list to prioritise. volume = avg monthly searches, cpc in USD, competition 0-1, difficulty 0-100. Keywords without

  • keyword_search_volume

    Google search volume, CPC, competition, keyword difficulty and intent for up to 20 comma-separated keywords in one $0.04 GET (Google Ads data). Use when you need monthly search volume for a few keywords in a country. volume = avg monthly searches, cpc in USD, competition 0-1, dif

  • keyword_ideas

    Keyword ideas for a seed keyword, each with Google search volume, CPC, competition, keyword difficulty and search intent; up to 100 ideas in one $0.04 call (Google Ads data). Use when you need related keywords to target. volume = avg monthly searches, cpc in USD, competition 0-1,

  • google_trends

    Google Trends interest over time for one keyword: a dated 0-100 series for a country or worldwide, past 7 days to 5 years, in one $0.045 GET. Use when you need search-interest trends, seasonality or demand direction for a keyword. Daily points for short windows, weekly for 12 mon

  • google_trends_related_queries

    Google Trends related queries for one keyword: the top related searches (0-100) and the rising ones (% growth), for a country or worldwide, past 7 days to 5 years, in one $0.03 GET. Use when you need query expansion, content ideas or emerging searches around a keyword. A live cal

  • google_trends_by_region

    Google Trends interest by region for one keyword: 0-100 interest per subregion of a country (or per country worldwide), past 7 days to 5 years, in one $0.03 GET. Use when you need where a keyword is searched most, for geo-targeting or local market research. A live call takes up t

  • related_keywords

    Related keywords for a seed from Google's 'searches related to' graph, to a depth of 0-4, each with search volume, CPC, competition, keyword difficulty and search intent; up to 100 in one $0.04 call (Google Ads data). Use when you need topic clusters around a keyword. Each row ha

  • keyword_variations

    Keyword variations: long-tail Google searches that contain a seed phrase, each with search volume, CPC, competition, keyword difficulty and search intent; up to 100 in one $0.04 call (Google Ads data). Use when you need phrase-match ideas for a keyword, sorted by volume. No match

  • keyword_difficulty

    Keyword difficulty (0-100: how hard it is to rank in Google's top 10) for up to 100 keywords in one $0.04 call. Use when you need to prioritise keywords by ranking difficulty. Keywords are normalised to lower case; over 100 keywords is a free 400. Keywords without a score are lis

  • search_intent

    Search intent of up to 100 keywords in one $0.04 call: the main intent (informational, navigational, commercial or transactional) with its probability, plus secondary intents. Use when you need to map keywords to funnel stage or content type. Any language; no location needed. Ove

  • keyword_volume_history

    Monthly Google search volume history for up to 20 keywords in one $0.048 call: every month the data has (typically several years), oldest first, plus current volume, CPC and competition (Google Ads data). Use when you need seasonality or long-term demand trends. Over 20 keywords

  • keywords_for_site

    Keyword suggestions for a website or one page: the Google searches relevant to it, each with search volume, CPC, competition, keyword difficulty and search intent; up to 100 in one $0.04 call (Google Ads data). Use when you need keyword ideas from a domain (www. is dropped) or a

  • google_trends_compare

    Google Trends comparison of up to 5 keywords: one relative 0-100 interest series for all of them (same scale), with each keyword's average and latest value; worldwide or one country, 7 days to 5 years, web, news or YouTube search, in one $0.045 call. Use when you need to compare

  • domain_overview

    Domain overview: a domain's Google SEO footprint in one market: organic and paid ranking keywords, estimated monthly traffic (etv) and its ad value, and keywords in position 1, top 3, top 10 and top 100, in one $0.04 call. Use when you need a quick SEO size-up of a website or com

  • traffic_estimate

    Traffic estimate for up to 100 domains in one $0.04 call: each domain's estimated monthly organic and paid visits from Google (etv) and its count of ranking keywords. Use when you need to compare the search traffic of many websites at once (bare domains; www. is dropped). A domai

  • ranked_keywords

    Ranked keywords: the Google keywords a domain ranks for, each with its position, ranking URL, estimated traffic and the keyword's search volume, CPC, difficulty and intent; up to 100 in one $0.048 call. Use when you need a site's or competitor's organic keywords (bare domain; www

  • competitor_domains

    Competitor domains: the websites competing with a domain in Google organic search, each with the keywords both rank for, the average position on them, and the competitor's total ranking keywords and estimated traffic; up to 100 in one $0.048 call. Use when you need to find a site

  • keyword_gap

    Keyword gap: the Google keywords a competitor ranks for and your domain does not, each with the competitor's position, URL and estimated traffic plus search volume, CPC, difficulty and intent; up to 100 in one $0.048 call. Use when you need content gaps and keyword opportunities

  • serp_competitors

    SERP competitors: the domains that rank in Google for a set of up to 100 keywords, each with average and median position, visibility, estimated traffic and how many of the keywords it ranks for; up to 100 domains in one $0.048 call. Use when you need who owns the search results o

  • relevant_pages

    Relevant pages: a domain's pages that get the most Google search traffic, each with its organic and paid ranking keywords, estimated monthly traffic, ad value and top-3/10/100 counts; up to 100 pages in one $0.048 call. Use when you need a site's top SEO pages (bare domain; www.

  • historical_rank

    Historical rank: a domain's monthly Google visibility over the last 24 months: organic and paid ranking keywords, estimated traffic (etv), its ad value and position 1 / top 3 / top 10 / top 100 counts per month, in one $0.25 call. Use when you need a site's SEO trajectory, traffi

  • page_intersection

    Page intersection: the Google keywords that up to 20 pages all rank for (minus keywords of up to 10 excluded pages), with each page's position, URL and estimated traffic plus search volume, CPC, difficulty and intent; up to 100 keywords in one $0.048 call. Use when you need the s

  • backlinks_summary

    Backlink profile of a domain: domain rank (0-1000), backlinks, referring domains, main domains, IPs and subnets, nofollow and broken links, spam score, first seen, and breakdowns by link type, TLD and country, from a web link index, in one $0.048 call. Use when you need a site's

  • backlinks_list

    Backlinks of a domain, strongest first: linking page URL and domain, target URL, anchor text, link type, dofollow, first and last seen, and the rank (0-1000) of the linking domain and page, up to 100 rows per $0.048 call, optionally dofollow only, from a web link index. Use when

  • referring_domains

    Domains linking to a domain, strongest first: each referring domain's rank (0-1000), backlinks and linking pages to the target, nofollow and broken links, first seen and spam score, up to 100 rows per $0.048 call, from a web link index. Use when sizing or comparing a site's link

  • backlink_anchors

    Anchor texts of the links to a domain, most used first: each anchor's backlinks, referring domains and main domains, nofollow domains and first seen, up to 100 rows per $0.048 call, from a web link index. Use when checking anchor-text distribution or over-optimisation. Anchors ar

  • backlinks_history

    Monthly history of a domain's backlink profile: rank (0-1000), backlinks, new and lost backlinks, referring domains, new and lost referring domains and main domains per month, for up to 24 months (from 2019 on; default the last 24 months) per $0.048 call, from a web link index. U

  • on_page_audit

    On-page SEO audit of one URL: HTTP status, on-page score (0-100), title, meta description, canonical, h1-h3, link, image and word counts, sizes, load timing and about 50 on-page checks (missing h1, duplicate tags, render-blocking resources...), from a page crawl, $0.012 a call. U

  • pagespeed

    Page speed of one URL from a real Lighthouse run: First Contentful Paint, Largest Contentful Paint, Total Blocking Time, Cumulative Layout Shift and Speed Index with their scores, the performance score when reported, final URL and version, mobile or desktop, $0.018 a call. Use wh

  • amazon_keywords

    Amazon keyword ideas for a seed: average monthly Amazon searches of the seed and of up to 100 related Amazon searches, each with its distance from the seed and the searches Amazon relates to it, US (or SA, AE, EG) market, from Amazon data, $0.04 a call. Use when researching produ

  • amazon_search

    Amazon search results for a query: up to 100 products of the results page with position, ASIN, title, product link, sponsored flag, price, currency, rating and rating count, bought-past-month, Amazon's Choice and Best Seller badges, plus related searches, 18 Amazon stores (defaul

  • google_search

    Google search results for a query: the organic results (rank, title, URL, domain, snippet), People Also Ask questions, related searches and the page's result types, for 10, 20 or 50 results in 94 countries, from Google search results, $0.018 a call. Use when checking who ranks fo

  • google_maps_search

    Google Maps places for a query in a country or around coordinates: up to 100 places with rank, name, category, address, phone, website, rating, review count, coordinates, price level and place id (no reviews or photos), from Google Maps, $0.018 a call. Use when building local-SEO

  • serp_history

    Google results page of a keyword as it was in the past: the first snapshot (about one a month) in a window of up to 31 days within the last year, with its top 10 organic results (rank, URL, domain, title), result count and result types, from Google search results, $0.018 a call.

  • business_listings

    Businesses listed on Google Maps by name and/or category in a country, optionally within a radius of a point: up to 50 with name, category, address, phone, website, rating, review count, coordinates, price level and place id (no reviews or photos), from Google Maps business listi

  • google_autocomplete

    Google autocomplete suggestions for a query or its start: up to 20 suggestions in Google's order with their relevance score, in 94 countries and their languages, from Google autocomplete, $0.012 a call. Use when finding the long-tail searches people type around a topic. Suggestio

  • bing_search

    Bing search results for a query: the organic results (rank, title, URL, domain, snippet), related searches and the page's result types, for 10, 20 or 50 results in 94 countries and Bing's 49 languages, from Bing search results, $0.018 a call. Use when checking rankings on Bing (a

  • youtube_search

    YouTube search results for a query: up to 20 or 40 videos with rank, video id and link, title, channel name and id, views, publication date and duration, in 94 countries, from YouTube search results, $0.012 a call. Use when checking which videos rank on YouTube for a topic. Title

  • google_ads_keywords

    Google Ads keyword ideas for up to 20 seed keywords: up to 100 ideas, highest search volume first, with monthly volume, CPC, competition and top-of-page bid range (optional monthly history), in 94 countries, from Google Ads data, $0.16 a call. Use when planning a paid or SEO keyw

  • clickstream_search_volume

    Search volume estimated from clickstream data (real user search behaviour, not Google Ads ranges) for up to 100 keywords: average monthly searches and optional 12-month history, in 94 countries, from clickstream panel data, $0.04 a call. Use when Google Ads volumes look bucketed

  • brand_mentions

    Web pages that mention a brand or keyword: up to 100 with URL, domain, date, sentiment (positive / negative / neutral with scores), the page's rating, page type, country, language and domain / page rank (no snippets or authors), from a web content index, $0.048 a call. Use when m

  • tech_stack

    The technology stack of a website: CMS, frameworks, JavaScript libraries, analytics and tag managers, CDN, web server, e-commerce and marketing tools, grouped by category, plus the domain's rank, country and language, from a web technology index, $0.024 a call. Use when profiling

  • whois_overview

    WHOIS overview of a domain: registered or not, registrar, creation, update and expiry dates, EPP status codes and TLD, plus its Google ranking keywords, estimated traffic and backlink counts (no registrant personal data), from WHOIS records, $0.21 a call. Use when checking a doma

  • llm_mentions

    AI answers that mention a brand or keyword: up to 20 questions answered by Google AI Overviews or ChatGPT that mention it, with AI search volume, first / last seen and the pages the answer cites (no answer text), in 94 countries (ChatGPT: US English), from AI search answers, $0.2

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 20, 2026

  • ! Caution

    Maker matches the repo

    The publisher (keywords.duoleads.com) is not the repo owner (hiesem); someone else may have listed it

  • ✓ Pass

    Still maintained

    Code last changed 9 days ago

  • ✓ Pass

    Has a licence

    Uses MIT

  • ✓ Pass

    Endpoint responds

    Responded in 240 ms (HTTP 200)

  • – Not applicable

    Sign-in with OAuth

    No sign-in needed

  • ✓ Pass

    No hidden instructions in tool descriptions

    Read 44 tool descriptions and found no hidden instructions to the AI

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/duoleads-keywords-keyword-search-volume-google-trends.svg)](https://mcp.popnx.com/en/servers/duoleads-keywords-keyword-search-volume-google-trends)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Marketing & social mediai

  • More stars than 0% of the other 4225 servers in this category
  • Published to the registry more recently than 76% of the other 4225 servers in this category
  • Basic checks equal to or better than 61% of the other 4225 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is SEO and Keyword Data API safe?

It passed 4 of 5 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs in the maker’s cloud. Connect over the internet with nothing to install, but what you send passes through the maker’s servers.

Is it still maintained?

The GitHub repo last changed 9 days ago, and the latest version (1.2.0) reached the registry 10 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT on the web (full MCP on Business and above; Pro read-only).

What can I use instead?

In the same category: Relaticle, ChatbotX, X (Twitter) MCP Server by Xquik, Betterlytics, BibiGPT YouTube Video Summarizer

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

ChatbotX

Omnichannel customer messaging, CRM contacts, flows, sequences, broadcasts, and AI automation.

by ChatbotXIOGrowing★ 1.1K Stars for the whole repoUpdated 14 days ago

Runs in the cloud✓ service owner · chatbotx.io

Betterlytics

Query your Betterlytics web analytics from AI agents: traffic, funnels, journeys, errors, uptime.

by betterlyticsGrowing★ 196Updated 4 months ago

Runs in the cloud✓ service owner · betterlytics.io
Compared with similar ones
This one
SEO and Keyword Data API
RelaticleChatbotXX (Twitter) MCP Server by XquikBetterlyticsBibiGPT YouTube Video Summarizer
Runs whereRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to install
Needs a keyNoNoNoNoYesNo
Add with + in ClaudeNoNoNoNoNoNo
Basic checks4/54/44/44/44/44/4
LicenseMITAGPL-3.0NOASSERTIONMITAGPL-3.0MIT
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

x402-seo-keyword-data

SEO and keyword data API for AI agents: Google search volume, CPC, keyword difficulty, keyword ideas, Google Trends, SERP results, backlinks, domain rankings, keyword gap, on-page audits and more. 44 routes, $0.012 to $0.25 per call, paid per request with x402 (USDC on Base). No API key, no signup, no subscription.

This is the TypeScript client for https://keywords.duoleads.com. It is also part of duo-data-utilities (as client.keywords); this package has the keyword client only.

Install

npm install x402-seo-keyword-data viem

viem creates the wallet account that pays. Node.js 20 or later.

Python: pip install x402-seo-keyword-data (the same client in snake_case; source in python/).

Quick start

import { privateKeyToAccount } from "viem/accounts";

import { createClient } from "x402-seo-keyword-data";

// Your wallet holds USDC on Base. Read the key from the environment, never a literal. const client = createClient({ account: privateKeyToAccount(process.env.PAYER_KEY as 0x${string}) });

const volume = await client.searchVolume({ keywords: ["phone", "watch"], country: "us" }); // $0.04 const ideas = await client.keywordIdeas({ keyword: "seo api", limit: 50 }); // $0.04 const trend = await client.trend({ keyword: "seo tools", timeframe: "past_12_months" }); // $0.045 const serp = await client.serp({ q: "coffee maker", country: "us" }); // $0.018 const gap = await client.keywordGap({ domain: "example.com", competitor: "example.org" }); // $0.048 const links = await client.backlinks({ target: "example.com" }); // $0.048

Each method sends the route's request (most are POST with a JSON body, a few GET), pays the 402 challenge with your wallet and resolves to the JSON answer. client.callWithReceipt(path, params) also returns the settlement receipt (transaction hash).

Price guard

Before anything is signed, the client checks the payment requirement: Base USDC only, only to the service's address 0xCD673f7e1daD254347AEab6be0DEFe8b9C6b3A39, and never above the cap. By default each route is capped at its own listed price; createClient({ account, maxPriceUsd: 0.05 }) sets one cap for every route. A refused call signs nothing and throws PriceGuardError. The client never retries a paid call on its own.

Errors and charges

A bad input is answered free with a 400; an upstream failure is a 503 with "nothing was charged". Both throw DuoApiError with code, param, expected and requestId.

Routes

MethodRoutePriceMCP toolWhat it returns
client.keywordOverviewPOST /v1/keyword-overview$0.04keyword_overviewKeyword overview (up to 100 keywords)
client.searchVolumeGET /v1/search-volume$0.04keyword_search_volumeSearch volume (GET, up to 20 keywords)
client.keywordIdeasPOST /v1/keyword-ideas$0.04keyword_ideasKeyword ideas (up to 100 per seed)
client.trendGET /v1/trend$0.045google_trendsGoogle Trends interest over time
client.relatedQueriesGET /v1/related-queries$0.03google_trends_related_queriesGoogle Trends related queries
client.interestByRegionGET /v1/interest-by-region$0.03google_trends_by_regionGoogle Trends interest by region
client.relatedKeywordsPOST /v1/related-keywords$0.04related_keywordsRelated keywords (up to 100, depth 0-4)
client.keywordVariationsPOST /v1/keyword-variations$0.04keyword_variationsKeyword variations containing a phrase (up to 100)
client.keywordDifficultyPOST /v1/keyword-difficulty$0.04keyword_difficultyKeyword difficulty (up to 100 keywords)
client.searchIntentPOST /v1/search-intent$0.04search_intentSearch intent (up to 100 keywords)
client.keywordVolumeHistoryPOST /v1/keyword-volume-history$0.048keyword_volume_historyMonthly search volume history (up to 20 keywords)
client.keywordSuggestionsPOST /v1/keyword-suggestions$0.04keywords_for_siteKeywords for a site or page (up to 100)
client.trendsPOST /v1/trends$0.045google_trends_compareGoogle Trends comparison (up to 5 keywords)
client.domainOverviewPOST /v1/domain-overview$0.04domain_overviewDomain overview (organic and paid visibility)
client.trafficEstimatePOST /v1/traffic-estimate$0.04traffic_estimateTraffic estimate (up to 100 domains)
client.rankedKeywordsPOST /v1/ranked-keywords$0.048ranked_keywordsRanked keywords of a domain (up to 100)
client.competitorsPOST /v1/competitors$0.048competitor_domainsCompetitor domains (up to 100)
client.keywordGapPOST /v1/keyword-gap$0.048keyword_gapKeyword gap: competitor-only keywords (up to 100)
client.serpCompetitorsPOST /v1/serp-competitors$0.048serp_competitorsDomains ranking for a keyword set (up to 100)
client.relevantPagesPOST /v1/relevant-pages$0.048relevant_pagesTop pages of a domain (up to 100)
client.historicalRankPOST /v1/historical-rank$0.25historical_rankMonthly rank history of a domain (24 months)
client.pageIntersectionPOST /v1/page-intersection$0.048page_intersectionKeywords shared by pages (up to 20 pages)
client.backlinksPOST /v1/backlinks$0.048backlinks_summaryBacklink profile summary
client.backlinksListPOST /v1/backlinks-list$0.048backlinks_listBacklinks list (up to 100)
client.referringDomainsPOST /v1/referring-domains$0.048referring_domainsReferring domains (up to 100)
client.backlinkAnchorsPOST /v1/backlink-anchors$0.048backlink_anchorsBacklink anchor texts (up to 100)
client.backlinksHistoryPOST /v1/backlinks-history$0.048backlinks_historyBacklink profile history (up to 24 months)
client.onPagePOST /v1/on-page$0.012on_page_auditOn-page SEO audit of a URL
client.pagespeedPOST /v1/pagespeed$0.018pagespeedPage speed (Lighthouse Core Web Vitals)
client.amazonKeywordsPOST /v1/amazon-keywords$0.04amazon_keywordsAmazon keyword ideas and volume
client.amazonSearchPOST /v1/amazon-search$0.012amazon_searchAmazon search results (products)
client.serpGET /v1/serp$0.018google_searchGoogle search results (10, 20 or 50)
client.mapsSearchGET /v1/maps-search$0.018google_maps_searchGoogle Maps places (up to 100)
client.serpHistoryPOST /v1/serp-history$0.018serp_historyGoogle results-page history (one past snapshot)
client.businessListingsPOST /v1/business-listings$0.08business_listingsBusiness listings by name or category (up to 50)
client.autocompleteGET /v1/autocomplete$0.012google_autocompleteGoogle autocomplete suggestions
client.bingSerpGET /v1/bing-serp$0.018bing_searchBing search results (10, 20 or 50)
client.youtubeSearchGET /v1/youtube-search$0.012youtube_searchYouTube search results (20 or 40)
client.googleAdsKeywordsPOST /v1/google-ads-keywords$0.16google_ads_keywordsGoogle Ads keyword ideas (up to 100)
client.clickstreamSearchVolumePOST /v1/clickstream-search-volume$0.04clickstream_search_volumeClickstream search volume (up to 100 keywords)
client.brandMentionsPOST /v1/brand-mentions$0.048brand_mentionsBrand mentions on the web (up to 100)
client.techStackPOST /v1/tech-stack$0.024tech_stackWebsite technology stack
client.whoisPOST /v1/whois$0.21whois_overviewWHOIS overview of a domain
client.llmMentionsPOST /v1/llm-mentions$0.21llm_mentionsAI answers mentioning a keyword (up to 20)

SEO_KEYWORD_ROUTES holds this table as data (path, HTTP method, MCP tool, price).

MCP and plain HTTP

The same 44 tools are a paid MCP server at https://keywords.duoleads.com/mcp (Streamable HTTP; tools/list is free). Every route also works without this package: an unpaid request returns 402 Payment Required with a PAYMENT-REQUIRED header, and any x402 v2 client can pay it.

Links

  • Docs: https://keywords.duoleads.com/docs
  • OpenAPI: https://keywords.duoleads.com/openapi.json
  • Machine-readable index: https://keywords.duoleads.com/llms.txt
  • Terms: https://keywords.duoleads.com/terms
  • Privacy: https://keywords.duoleads.com/privacy
  • Listed on PayAPI Market (settlement-verified): https://payapi.market/api/seo-and-keyword-data-api

Data only: search volumes, CPC and rankings are estimates from third-party providers and public sources; not affiliated with or endorsed by Google, Bing, YouTube or Amazon.

Source

Source: github.com/hiesem/x402-seo-keyword-data is a generated mirror of this package from the duo-data-utilities monorepo (packages/x402-seo-keyword-data); issues are welcome in either repository.

License

MIT. See LICENSE.