Keywords · MCP TOOL

find_easier_keywords

Find and score lower-competition alternatives to a seed keyword.

Set up your assistant · Authentication and errors

When to use it

Expand store autocomplete into candidates with difficulty gaps and explanations. live and expand bound store work; unscored reports candidates left without scores.

Parameters

Name	Type	Required	Default	Allowed values	Description
`keyword`	string	Yes	`—`	—	Store search term to score or inspect. Minimum length: 1. Maximum length: 80.
`country`	string	No	`"us"`	—	Two-letter storefront country code. Minimum length: 2. Maximum length: 2.
`source`	string	No	`"apple_mobile"`	apple_mobile, google_mobile, ios, android	Store: apple_mobile/ios or google_mobile/android.
`limit`	integer	No	`12`	—	Maximum number of results requested. Minimum: 1. Maximum: 20.
`live`	integer	No	`6`	—	Budget for live candidate scoring calls. Minimum: 0. Maximum: 15.
`expand`	integer	No	`4`	—	Budget for second-level autocomplete expansion. Minimum: 0. Maximum: 8.
`minDifficultyDrop`	integer	No	`5`	—	Minimum difficulty drop for a candidate to be marked easier. Minimum: 0. Maximum: 100.
`minPopularity`	integer	No	`15`	—	Minimum popularity for a candidate to be marked easier. Minimum: 0. Maximum: 100.
`refresh`	boolean	No	`false`	—	Bypass cached keyword work when true.

Defaults and constraints come from the published Zod input schema. “—” means no schema default or no enum restriction. Use JSON values of the listed type; additional handler rules are described above.

Example prompts

Find easier alternatives to sleep sounds in the US App Store.

Example call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "find_easier_keywords",
    "arguments": {
      "keyword": "sleep sounds",
      "country": "us",
      "live": 6
    }
  }
}

Example result

Illustrative, abridged JSON-RPC result. Only selected fields are shown; empty arrays illustrate a response with no rows. These are not current catalog observations. Parse the JSON inside content[].text.

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"data\":{\"unscored\":[]}}"
      }
    ]
  }
}

Free vs paid results

Free hides the seed’s popularity, traffic and opportunity and the top five suggestion terms; candidate scores remain visible. opportunityGain and seed-demand figures in reasons are removed. Paid plans unlock these fields.

Paid access does not fill coverage gaps or unknown values. Returned plan metadata and lock notes explain redaction where applicable. Read the full Free data policy.

Rate limits and usage credit

Plan	Calls per tool / day	All tools / week
Free	5	50
Basic	100	700
Pro	300	2,500

Days reset at 00:00 UTC. The combined ISO week resets Monday at 00:00 UTC. Every served tool call counts, including cached reads. Failed or refused calls are released along with any charge. Compare plans.

After either allowance, Basic and Pro can opt in to pay $0.05 in usage credit per call to find_easier_keywords. A call exceeding both windows is charged once. Free is refused past its allowances; paid plans without opt-in or enough credit are also refused with HTTP 402 / JSON-RPC -32004.

Credential request throttles and, for live keyword work, store-work throttles also apply. Follow retry instructions in the error reference.