THE MINER MCP — Analista de oportunidades REAIS de lucro (e-commerce, dropshipping, infoprodutos). Gera Opportunity Score, Confidence Score, saturação, gaps e recomendação ENTRAR/TESTAR/AGUARDAR/EVITAR. Use generate_full_niche_report para pesquisas completas.
The Miner MCP has 11 tools with significant definition quality gaps. Tool names lack clear action verbs (e.g., 'analyze_niche_full' vs 'generate_full_niche_report' are near-duplicates). Descriptions are verbose (200+ chars) and written in Portuguese with marketing language ('★ PRINCIPAL ★') rather than LLM-optimized English. Input schemas are present but minimal, most parameters lack type constraints (no enums for country codes, time_period, depth). Output schemas are completely undocumented; responses mention 'visual markdown', 'SVG charts', 'JSON' but no structured field definitions. Error handling is absent from tool definitions. Two tools (generate_full_niche_report, analyze_niche_full) appear to be duplicates with identical descriptions and inputs, violating the single-responsibility principle.
Analyze Facebook Ad Library creatives and campaigns. Returns visual markdown, SVG chart, embed link to Ad Library, plus structured JSON with scaling signals.
Research SEO signals from Google Trends, PAA, Reddit, Wikipedia. Returns visual markdown, opportunity gauge + regional chart (SVG), embed links, plus JSON.
Analyze landing page conversion elements, triggers, CTAs, and offers. Returns visual markdown, conversion score gauge + trigger chart (SVG), plus JSON.
Search Mercado Livre (API) and Shopee for marketplace demand, supplier availability, saturation, avg price/sales. Visual markdown + JSON.
★ PRINCIPAL ★ Inteligência estratégica em 1 chamada: Opportunity Score ponderado, Confidence Score, Mercado Livre+Shopee, Meta, TikTok, Google, YouTube, Trending. Recomendação ENTRAR|TESTAR|AGUARDAR|EVITAR. NÃO use tools individuais para relatório completo.
Duplicate tools with identical signatures: generate_full_niche_report and analyze_niche_full both accept {niche, country} and return identical descriptions. This violates single-responsibility principle and forces LLMs to guess which to call.
Descriptions are marketing copy in Portuguese with emoji ('★ PRINCIPAL ★') rather than LLM-optimized English. Descriptions exceed 200 chars and lack clarity on WHEN to use each tool vs alternatives.
Inferred effective spec: 2026-07-28+.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 38 | 2026-07-28+ | v2 |
Analyze TikTok Creative Center ads and hooks. Returns visual markdown, format chart (SVG), Creative Center embed link, plus structured JSON.
Analyze YouTube video trends for a keyword. Returns visual markdown with top videos, Mermaid chart, SVG views chart, embed links, plus structured JSON metrics.
★ PRINCIPAL ★ Inteligência estratégica em 1 chamada: Opportunity Score ponderado, Confidence Score, Mercado Livre+Shopee, Meta, TikTok, Google, YouTube, Trending. Recomendação ENTRAR|TESTAR|AGUARDAR|EVITAR. NÃO use tools individuais para relatório completo.
Synthesize collected mining data into a rich visual report: markdown summary with Mermaid charts, SVG score/channel charts (image blocks), embed links (Ad Library, Trends, YouTube), plus structured JSON with opportunity score (0-100).
Discover trending products via Reddit and Google Trends. Returns visual markdown, trend score chart (SVG), embed links, plus structured JSON.
Scrape competitor funnels and pricing. Returns visual markdown with Mermaid funnel flow, SVG funnel diagram, insights, plus structured JSON.
Input parameters lack type constraints and enums. 'country' accepts free-form strings (no enum of valid codes); 'time_period' has no enum (e.g., last_7_days, last_30_days); 'depth' is free-form.
Output schemas are completely undocumented. Tool descriptions mention 'visual markdown', 'SVG charts', 'JSON', 'Mermaid charts', 'embed links' but no structured field definitions. LLMs cannot plan downstream calls or extract data without knowing response structure.
No error handling guidance in tool definitions. Tools that scrape external APIs (Reddit, Google Trends, Facebook Ad Library, TikTok, YouTube) have no documented error cases, recovery steps, or retry guidance. Per pattern, errors must tell LLMs what to do next.