Stored keyword metrics
hive_keyword_metricsReads stored popularity and difficulty scores for one exact keyword in a chosen storefront, with evidence, freshness and status per metric. Read-only; it never starts a measurement.
Instructions
Read the stored popularity (integer 1–100) and difficulty (0–100) of one exact keyword in one storefront. Each metric has its own evidence, source time, freshness and last-attempt status; a missing value stays null and is never zero. This read never starts a measurement — use hive_measure_keyword_metrics for that. iOS only.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"term": "<term>"
},
"name": "hive_keyword_metrics"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| term | Yes | exact keyword, e.g. habit tracker | |
| country | No | storefront code, e.g. us (defaults to us) |