How do I install the Sensortower skill?

Run npx skillmds@latest add finpeakinc/sensortower in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Sensortower safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Sensortower?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Sensortower free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Sensortower?

finpeakinc (@finpeakinc) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Sensortower by finpeakinc — Agent Skill

Name: Sensortower
Author: finpeakinc

Sensortower

Query Sensor Tower app intelligence through its API for app or publisher search, download and revenue estimates, top charts, DAU/WAU/MAU active users, publisher app portfolios, and advertising intelligence. Use when the user asks for Sensor Tower data, mobile app or game market estimates, app rankings, publisher titles, active-user metrics, competitor ad creatives, or SensorTower API lookups.

finpeakinc 4a3acac 8 files · 28.6 KB Updated Sep 17, 2026

File contents

Sensor Tower

Use the bundled CLI for Sensor Tower queries. Return the API JSON unchanged unless the user asks for a summary or transformation.

Requirements

Python 3.9 or newer
SENSORTOWER_AUTH_TOKEN in the environment
Sensor Tower API access for the requested endpoint

No manual pip install is required. Always invoke scripts/run.py; it reads requirements.txt and installs any future pinned dependencies into an isolated per-user cache on first use. Dependencies must include trusted artifact hashes. The current release has no third-party dependencies.

Never print, quote, or return the token. Do not pass it as a command-line argument.

Workflow

Identify the smallest matching action.
Collect required IDs, platform, countries, and dates. Do not guess them.
Run python3 <skill-path>/scripts/run.py <action> ... once. Do not bypass the runner.
If the command fails, report the sanitized error. Do not retry with different parameters unless the error identifies an invalid field or the user approves a change.
Summarize relevant fields by default and preserve uncertainty: Sensor Tower values are estimates, not audited financials.

Actions

Search apps or publishers

python3 <skill-path>/scripts/run.py search \
  --term "Royal Match" \
  --entity-type app \
  --os unified \
  --limit 10

Use --entity-type publisher for publisher lookup.

Downloads and revenue estimates

python3 <skill-path>/scripts/run.py sales \
  --app-id 1482938460 \
  --os ios \
  --countries US,GB \
  --start 2026-03-01 \
  --end 2026-03-31 \
  --granularity monthly

Pass exactly one of --app-id or --publisher-id. Use only ios or android.

Top charts

python3 <skill-path>/scripts/run.py top-charts \
  --measure revenue \
  --countries US \
  --category 6014 \
  --limit 20

Optional dates default to the trailing 30 days.

Active users

python3 <skill-path>/scripts/run.py active-users \
  --app-id 1482938460 \
  --os ios \
  --metric DAU \
  --countries US \
  --start 2026-03-01 \
  --end 2026-03-31

Require a platform-specific app ID and one platform. Never reuse one ID across both platforms automatically.

Publisher apps

python3 <skill-path>/scripts/run.py publisher-apps \
  --publisher-id 12345 \
  --os unified

Advertising intelligence

python3 <skill-path>/scripts/run.py ad-intelligence \
  --action creatives \
  --app-id 1482938460 \
  --countries US \
  --limit 20

overview and creatives require --app-id; top-advertisers does not.

Output and errors

Success: validated JSON on stdout.
Optional --output PATH: write the same JSON to the selected file.
Failure: sanitized diagnostic on stderr and non-zero exit status.
No action silently converts API failures into empty results.
The CLI validates dates, country codes, positive limits, and response JSON before returning.

For endpoint and parameter details, read references/api.md.

---name: sensortowerdescription: Query Sensor Tower app intelligence through its API for app or publisher search, download and revenue estimates, top charts, DAU/WAU/MAU active users, publisher app portfolios, and advertising intelligence. Use when the user asks for Sensor Tower data, mobile app or game market estimates, app rankings, publisher titles, active-user metrics, competitor ad creatives, or SensorTower API lookups.---# Sensor TowerUse the bundled CLI for Sensor Tower queries. Return the API JSON unchanged unless the user asks for a summary or transformation.## Requirements- Python 3.9 or newer- `SENSORTOWER_AUTH_TOKEN` in the environment- Sensor Tower API access for the requested endpointNo manual `pip install` is required. Always invoke `scripts/run.py`; it reads`requirements.txt` and installs any future pinned dependencies into an isolatedper-user cache on first use. Dependencies must include trusted artifact hashes.The current release has no third-party dependencies.Never print, quote, or return the token. Do not pass it as a command-line argument.## Workflow1. Identify the smallest matching action.2. Collect required IDs, platform, countries, and dates. Do not guess them.3. Run `python3 <skill-path>/scripts/run.py <action> ...` once. Do not bypass the runner.4. If the command fails, report the sanitized error. Do not retry with different parameters unless the error identifies an invalid field or the user approves a change.5. Summarize relevant fields by default and preserve uncertainty: Sensor Tower values are estimates, not audited financials.## Actions### Search apps or publishers```bashpython3 <skill-path>/scripts/run.py search \ --term "Royal Match" \ --entity-type app \ --os unified \ --limit 10```Use `--entity-type publisher` for publisher lookup.### Downloads and revenue estimates```bashpython3 <skill-path>/scripts/run.py sales \ --app-id 1482938460 \ --os ios \ --countries US,GB \ --start 2026-03-01 \ --end 2026-03-31 \ --granularity monthly```Pass exactly one of `--app-id` or `--publisher-id`. Use only `ios` or `android`.### Top charts```bashpython3 <skill-path>/scripts/run.py top-charts \ --measure revenue \ --countries US \ --category 6014 \ --limit 20```Optional dates default to the trailing 30 days.### Active users```bashpython3 <skill-path>/scripts/run.py active-users \ --app-id 1482938460 \ --os ios \ --metric DAU \ --countries US \ --start 2026-03-01 \ --end 2026-03-31```Require a platform-specific app ID and one platform. Never reuse one ID across both platforms automatically.### Publisher apps```bashpython3 <skill-path>/scripts/run.py publisher-apps \ --publisher-id 12345 \ --os unified```### Advertising intelligence```bashpython3 <skill-path>/scripts/run.py ad-intelligence \ --action creatives \ --app-id 1482938460 \ --countries US \ --limit 20````overview` and `creatives` require `--app-id`; `top-advertisers` does not.## Output and errors- Success: validated JSON on stdout.- Optional `--output PATH`: write the same JSON to the selected file.- Failure: sanitized diagnostic on stderr and non-zero exit status.- No action silently converts API failures into empty results.- The CLI validates dates, country codes, positive limits, and response JSON before returning.For endpoint and parameter details, read [references/api.md](references/api.md).

Frequently asked questions