{
  "markdown": "# app-store-trends-mcp\n\nApp download trends as an MCP tool. Plug into Claude, Cursor, or any MCP-compatible AI host. Weekly series, growth percentages, and live top charts.\n\nPowered by **[trendsmcp.ai](https://trendsmcp.ai)** — one API key, one client, **30+ data sources**: Google Search, YouTube, TikTok, Reddit, Amazon, Wikipedia, App Store, Steam, npm, news volume, news sentiment, live trending feeds, and more. No separate credentials per platform.\n\n**[Get your free API key → trendsmcp.ai](https://trendsmcp.ai)** — 100 free requests/month, no credit card.\n\n📖 **[Full API docs → trendsmcp.ai/docs](https://trendsmcp.ai/docs)**\n\nUpdated for 2026. Works with Python 3.8 through 3.13.\n\n## Quick install\n\nSame four clients as the site hero. [Get a free key](https://www.trendsmcp.ai/account) first (100 req/mo). Claude and ChatGPT sign you in with OAuth. Cursor and VS Code: click, then put your key from `/account` if the deeplink used a placeholder.\n\n<p align=\"center\">\n  <a href=\"https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Trends%20MCP&connectorUrl=https%3A%2F%2Fwww.trendsmcp.ai%2Fmcp\"><img src=\"https://img.shields.io/badge/Add_to-Claude-DA7756?style=for-the-badge&logo=claude&logoColor=white\" alt=\"Add to Claude\"></a>\n  <a href=\"cursor://anysphere.cursor-deeplink/mcp/install?name=trends-mcp&config=eyJ1cmwiOiJodHRwczovL2FwaS50cmVuZHNtY3AuYWkvbWNwIiwidHJhbnNwb3J0IjoiaHR0cCIsImhlYWRlcnMiOnsiQXV0aG9yaXphdGlvbiI6IkJlYXJlciBZT1VSX0FQSV9LRVkifX0%3D\"><img src=\"https://img.shields.io/badge/Add_to-Cursor-000000?style=for-the-badge\" alt=\"Add to Cursor\"></a>\n  <a href=\"https://chatgpt.com/plugins#settings/Connectors?create-connector=true&redirectAfter=%2Fplugins\"><img src=\"https://img.shields.io/badge/Add_to-ChatGPT-10A37F?style=for-the-badge\" alt=\"Add to ChatGPT\"></a>\n  <a href=\"https://www.trendsmcp.ai/account\"><img src=\"https://img.shields.io/badge/Add_to-VS_Code-007ACC?style=for-the-badge&logo=visualstudiocode&logoColor=white\" alt=\"Add to VS Code\"></a>\n</p>\n\n| Client | After you click |\n|---|---|\n| **Claude** | Connector name and URL are prefilled (`https://www.trendsmcp.ai/mcp`). Confirm, then authorize. |\n| **Cursor** | Approve the MCP install. Replace `YOUR_API_KEY` if prompted. |\n| **ChatGPT** | Enable Developer mode (Profile → Settings → Security). Name `Trends MCP`, URL `https://www.trendsmcp.ai/mcp`, then authorize. |\n| **VS Code** | Sign in on the account page and use the **VS Code** button so the key is included. |\n\nThen ask: `Using TrendsMCP, what's trending on Google right now?`\n\n## Use as an MCP tool\n\nAdd to your `mcp.json` (Claude Desktop, Cursor, Windsurf, VS Code, or any MCP host):\n\n```json\n{\n  \"mcpServers\": {\n    \"trends-mcp\": {\n      \"url\": \"https://api.trendsmcp.ai/mcp\",\n      \"transport\": \"http\",\n      \"headers\": { \"Authorization\": \"Bearer YOUR_API_KEY\" }\n    }\n  }\n}\n```\n\nGet your free key at **[trendsmcp.ai](https://trendsmcp.ai)**. Full setup instructions for Claude, Cursor, Windsurf, and VS Code at **[trendsmcp.ai/docs](https://trendsmcp.ai/docs)**.\n\n---\n\n## No scraping. No 429 errors. No proxies.\n\nIf you have used pytrends or similar scrapers before, you know the problems: random `429 Too Many Requests` blocks, broken pipelines at 2am, time.sleep() hacks, proxy rotation costs, and a library that is now **archived** because Google explicitly flags scrapers at the protocol level.\n\ntrendsmcp is the managed alternative. We run the data infrastructure. You call a REST endpoint.\n\n### pytrends alternative for App Store data\n\n| | Scrapers / pytrends | trendsmcp |\n|---|---|---|\n| 429 rate limit errors | constant | never |\n| Proxy required | often | never |\n| Breaks on platform changes | yes, regularly | no |\n| Data sources covered | 1 (Google only) | 30+ |\n| Absolute volume estimates | no | yes |\n| Cross-platform growth | no | yes |\n| Async support | no | yes |\n| Actively maintained | no (archived) | yes |\n| Free tier | no | yes, 100 req/month |\n\n---\n\n## Install\n\n```bash\npip install app-store-trends-mcp\n```\n\nZero system dependencies. Python 3.8 or later. Uses `httpx` under the hood.\n\n---\n\n## Quick start\n\n```python\nfrom app_store_trends_mcp import TrendsMcpClient, SOURCE\n\nclient = TrendsMcpClient(api_key=\"YOUR_API_KEY\")\n\n# 5-year weekly time series — no sleep(), no proxies, no 429s\nseries = client.get_trends(source=SOURCE, keyword=\"com.openai.chatgpt\")\nprint(series[0])\n# TrendsDataPoint(date='2026-03-28', value=72, keyword='com.openai.chatgpt', source='app downloads')\n\n# Period-over-period growth\ngrowth = client.get_growth(\n    source=SOURCE,\n    keyword=\"com.openai.chatgpt\",\n    percent_growth=[\"3M\", \"1Y\"],\n)\nprint(growth.results[0])\n# GrowthResult(period='3M', growth=14.5, direction='increase', ...)\n\n# What's trending right now (across all live platforms)\ntrending = client.get_top_trends(limit=10)\nprint(trending.data)\n# [[1, 'topic one'], [2, 'topic two'], ...]\n```\n\n---\n\n## Async support\n\n```python\nimport asyncio\nfrom app_store_trends_mcp import AsyncTrendsMcpClient, SOURCE\n\nasync def main():\n    client = AsyncTrendsMcpClient(api_key=\"YOUR_API_KEY\")\n    series = await client.get_trends(source=SOURCE, keyword=\"com.openai.chatgpt\")\n    print(series[0])\n\nasyncio.run(main())\n```\n\nQuery multiple platforms concurrently with one key:\n\n```python\ngoogle, youtube, reddit, amazon, tiktok = await asyncio.gather(\n    client.get_trends(source=\"google search\", keyword=\"com.openai.chatgpt\"),\n    client.get_trends(source=\"youtube\",       keyword=\"com.openai.chatgpt\"),\n    client.get_trends(source=\"reddit\",        keyword=\"com.openai.chatgpt\"),\n    client.get_trends(source=\"amazon\",        keyword=\"com.openai.chatgpt\"),\n    client.get_trends(source=\"tiktok\",        keyword=\"com.openai.chatgpt\"),\n)\n```\n\n---\n\n## Use cases\n\n- **SEO research**: track keyword search volume trends across Google Search, Google News, and Google Images before publishing content\n- **Market research**: measure consumer demand signals on Amazon and Google Shopping before entering a product category\n- **Investment research**: monitor Reddit discussion volume, news sentiment, and Wikipedia page view spikes as leading indicators\n- **Content strategy**: find what is growing on YouTube and TikTok before topics peak and competition saturates them\n- **Competitor tracking**: compare brand search volume growth across platforms over custom date ranges\n- **App analytics**: track App Store interest and app download estimates alongside Reddit and news buzz\n\n---\n\n## Works with\n\n- **Claude** (via MCP — [trendsmcp.ai/docs](https://trendsmcp.ai/docs))\n- **Cursor** (via MCP — [trendsmcp.ai/docs](https://trendsmcp.ai/docs))\n- **ChatGPT** (via MCP — [trendsmcp.ai/docs](https://trendsmcp.ai/docs))\n- **Windsurf** (via MCP — [trendsmcp.ai/docs](https://trendsmcp.ai/docs))\n- **VS Code Copilot** (via MCP — [trendsmcp.ai/docs](https://trendsmcp.ai/docs))\n- **LangChain**: pass `TrendsMcpClient` output directly as tool results or context\n- **CrewAI**: wrap any method as a `Tool` and drop it into your crew\n- **AutoGen**: register as a callable tool for any agent\n- **LlamaIndex**: use trend series as structured data nodes for retrieval\n- **Pandas**: each `get_trends()` response converts to a DataFrame in one line\n\n---\n\n## Methods\n\n### `get_trends(source, keyword, data_mode=None)`\n\nReturns a historical time series for a keyword. Defaults to 5 years of weekly data. Pass `data_mode=\"daily\"` for the last 30 days at daily granularity.\n\n### `get_growth(source, keyword, percent_growth, data_mode=None)`\n\nCalculates percentage growth between two points in time. Pass preset strings or `CustomGrowthPeriod` objects.\n\n**Growth presets:** `7D` `14D` `30D` `1M` `2M` `3M` `6M` `9M` `12M` `1Y` `18M` `24M` `2Y` `36M` `3Y` `48M` `60M` `5Y` `MTD` `QTD` `YTD`\n\n### `get_top_trends(type=None, limit=None)`\n\nReturns today's live trending items. Omit `type` to get all feeds at once.\n\n**Available live feeds:** `Google Trends` `Google News Top News` `YouTube Trending` `TikTok Trending Hashtags` `X (Twitter) Trending` `Reddit Hot Posts` `Reddit World News` `Wikipedia Trending` `Amazon Best Sellers Top Rated` `Amazon Best Sellers by Category` `App Store Top Free` `App Store Top Paid` `Google Play` `Spotify Top Podcasts` `Top Websites`\n\n---\n\n## All 30+ data sources\n\nOne API key. One client. Every platform. No separate credentials for each.\n\n| source | What it measures |\n|---|---|\n| `\"google search\"` | Google Search volume |\n| `\"google images\"` | Google Images search volume |\n| `\"google news\"` | Google News search volume |\n| `\"google shopping\"` | Google Shopping purchase intent |\n| `\"youtube\"` | YouTube search volume |\n| `\"tiktok\"` | TikTok hashtag volume |\n| `\"reddit\"` | Reddit subreddit subscribers over time |\n| `\"amazon\"` | Amazon product search volume |\n| `\"wikipedia\"` | Wikipedia page views |\n| `\"news volume\"` | News article mention count |\n| `\"news sentiment\"` | News sentiment score (positive/negative) |\n| `\"app downloads\"` | Mobile app download/install estimates (Android) |\n| `\"npm\"` | npm package weekly downloads |\n| `\"steam\"` | Steam concurrent player count |\n\nAll values normalized 0–100 so you can compare across platforms directly.\n\n---\n\n## Error handling\n\n```python\nfrom app_store_trends_mcp import TrendsMcpClient, TrendsMcpError, SOURCE\n\nclient = TrendsMcpClient(api_key=\"YOUR_API_KEY\")\n\ntry:\n    series = client.get_trends(source=SOURCE, keyword=\"com.openai.chatgpt\")\nexcept TrendsMcpError as e:\n    print(e.status)   # e.g. 429 if you exceed your plan quota\n    print(e.code)     # e.g. \"rate_limited\"\n    print(e.message)\n```\n\n---\n\n## Frequently asked questions\n\n**Does this scrape App Store?**\nNo. trendsmcp runs managed data infrastructure. Your Python code makes a single authenticated REST call. No scraping, no Selenium, no cookies, no proxies required.\n\n**Do I need a App Store developer account, OAuth token, or platform API key?**\nNo. One trendsmcp API key gives you access to all 30+ data sources.\n\n**Will it break when App Store changes its backend?**\nNo. API stability is our responsibility. If something changes upstream, we update the backend. Your code keeps working.\n\n**Can I query multiple platforms with the same key?**\nYes. One key covers every data source. Switch `source` to any of the 30+ values listed above.\n\n**Is there a free tier?**\nYes, 100 requests per month, no credit card required. [Get your key at trendsmcp.ai](https://trendsmcp.ai).\n\n**Can I use this in production data pipelines?**\nYes. The client is stateless, thread-safe, and supports async for concurrent queries across multiple platforms.\n\n---\n\n## Related packages\n\n- [trendsmcp](https://pypi.org/project/trendsmcp/) — core package, all 30+ data sources\n- [youtube-trends-api](https://pypi.org/project/youtube-trends-api/) / [youtube-trends-mcp](https://pypi.org/project/youtube-trends-mcp/) / [youtube-trends-agent](https://pypi.org/project/youtube-trends-agent/)\n- [reddit-trends-api](https://pypi.org/project/reddit-trends-api/) / [reddit-trends-mcp](https://pypi.org/project/reddit-trends-mcp/) / [reddit-trends-agent](https://pypi.org/project/reddit-trends-agent/)\n- [google-search-trends-api](https://pypi.org/project/google-search-trends-api/) / [google-search-trends-mcp](https://pypi.org/project/google-search-trends-mcp/) / [google-search-trends-agent](https://pypi.org/project/google-search-trends-agent/)\n- [amazon-trends-api](https://pypi.org/project/amazon-trends-api/) / [amazon-trends-mcp](https://pypi.org/project/amazon-trends-mcp/) / [amazon-trends-agent](https://pypi.org/project/amazon-trends-agent/)\n- [tiktok-trends-api](https://pypi.org/project/tiktok-trends-api/) / [tiktok-trends-mcp](https://pypi.org/project/tiktok-trends-mcp/) / [tiktok-trends-agent](https://pypi.org/project/tiktok-trends-agent/)\n- [wikipedia-trends-api](https://pypi.org/project/wikipedia-trends-api/) / [wikipedia-trends-mcp](https://pypi.org/project/wikipedia-trends-mcp/) / [wikipedia-trends-agent](https://pypi.org/project/wikipedia-trends-agent/)\n- [npm-trends-api](https://pypi.org/project/npm-trends-api/) / [npm-trends-mcp](https://pypi.org/project/npm-trends-mcp/) / [npm-trends-agent](https://pypi.org/project/npm-trends-agent/)\n- [steam-trends-api](https://pypi.org/project/steam-trends-api/) / [steam-trends-mcp](https://pypi.org/project/steam-trends-mcp/) / [steam-trends-agent](https://pypi.org/project/steam-trends-agent/)\n- [app-store-trends-api](https://pypi.org/project/app-store-trends-api/) / [app-store-trends-mcp](https://pypi.org/project/app-store-trends-mcp/) / [app-store-trends-agent](https://pypi.org/project/app-store-trends-agent/)\n- [news-volume-api](https://pypi.org/project/news-volume-api/) / [news-volume-mcp](https://pypi.org/project/news-volume-mcp/) / [news-volume-agent](https://pypi.org/project/news-volume-agent/)\n- [news-sentiment-api](https://pypi.org/project/news-sentiment-api/) / [news-sentiment-mcp](https://pypi.org/project/news-sentiment-mcp/) / [news-sentiment-agent](https://pypi.org/project/news-sentiment-agent/)\n\n---\n\n## Links\n\n- [API docs](https://trendsmcp.ai/docs)\n- [Get a free API key](https://trendsmcp.ai)\n- [pytrends alternative](https://trendsmcp.ai/pytrends-alternative)\n- [All packages on PyPI](https://pypi.org/user/trendsmcp/)\n- [GitHub](https://github.com/trendsmcp/trendsmcp-py)\n\n---\n\n## License\n\nMIT\n",
  "bytes": 13273,
  "sha": "89de54ffeead3f1f3e40e4d42159391fb8ac9a828570b8dc09bce4fe83d0ab79",
  "repo_slug": "trendsmcp-ai/app-store-trends-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_ai_trendsmcp_app_store_0e47dc8f/readme"
}