Manual de operador SellerIVA MCP
La misma guía que lee Claude: mapa del producto, autenticación, cuotas, flujos y cada tool con parámetros y scopes.
La misma guía que lee Claude: mapa del producto, autenticación, cuotas, flujos y cada tool con parámetros y scopes.
Antes de integrar
- Claude lee datos del tenant y propone; tú apruebas en Ads → Automatización, Pedidos o Costes.
- PAT sv_mcp_* o OAuth 2.1. Conector: mcp.selleriva.com/mcp.
- Cuota ~60 requests/minuto por token. Revisa data_freshness antes de decidir.
- Copia el markdown a un Claude Project si quieres el manual fuera del MCP.
Meta
- get_account_brief (sales:read): Briefing de cuenta / estudiar cuenta / snapshot del tenant al abrir sesión.
- get_asin_dossier (sales:read): Ficha de un ASIN × país × mes: finanzas (ACOS+TACOS), stock, ranks orgánicos, ficha keyword de Exactas top spend, y pending Ads de ese ASIN.
- get_selleriva_playbook: Manual SellerIVA MCP: capabilities, qué puedes hacer, create campaign, harvest, cold start ASIN, decision_kind, inventario, restock, COGS, costes, pedido, playbook.
- save_account_directives (account:write): Guarda objetivos/reglas de la cuenta (memoria entre chats). Máx 3 objectives y 10 rules.
Sales
- get_data_freshness (sales:read): Devuelve el estado de sincronización y frescura de datos del tenant.
- get_products_performance (sales:read): Devuelve rendimiento por producto (SKU/ASIN): unidades, ingresos, margen visible.
- get_returns_events (sales:read): Eventos de devolución línea a línea (motivos, ASIN/SKU, disposición). Solo lectura.
- get_returns_summary (sales:read): Resumen de devoluciones: KPIs, razones, insights y frescura.
- get_sales_breakdown (sales:read): Devuelve desglose financiero P&L.
- get_sales_kpis (sales:read): Devuelve KPIs de ventas del tenant autenticado: ingresos, unidades, márgenes y devoluciones. Ventas / sales / revenue / units.
Reports
- get_client_reports (sales:read): Lista metadatos de informes cliente (HTML enviados + PDF mensuales). Sin binarios.
- get_fba_fee_claims (sales:read): Claims FBA de tarifas detectados / listos (solo lectura).
- get_monthly_report (sales:read): Preview JSON del informe mensual (insights / P&L). month=YYYY-MM.
Analytics
- get_brand_analytics_products (analytics:read): Devuelve oportunidades Brand Analytics agregadas por producto (ASIN).
- get_brand_analytics_queries (analytics:read): Devuelve recomendaciones Brand Analytics (SQP) por search query.
- get_keyword_competitors (analytics:read): Devuelve competidores top clicados para una keyword (Search Terms vs hero ASIN).
- get_listing_health (analytics:read): Señales de salud de listing (no scrape): weekly listing_blocker/buybox_leak, SQP improve_search_card/improve_detail_page, y buy box / CVR de tráfico.
- get_search_query_trend (analytics:read): Devuelve la evolución semanal de una search query para un ASIN y marketplace.
- get_traffic_report (analytics:read): Devuelve informe de tráfico (sesiones, page views, CVR, buy box) por ASIN.
- get_weekly_product_actions (analytics:read): Devuelve acciones semanales por producto / weekly actions (veredicto, severidad, plan).
Inventory
- get_inventory_decisions (inventory:read): Inventario FBA / restock / reposición / stock decisions (RestockCritical, AgingFeeRisk, OverstockWarning, ListingOptimization, Healthy). Solo lectura.
- get_product_costs (cogs:read): Costes de producto / COGS / unit cost / márgenes (catálogo unificado). Solo lectura.
- get_purchase_orders (inventory:read): Pedidos a proveedor / purchase orders / POs / restock orders. Solo lectura.
Ads
- get_ads_advertised_products (ads:read): Productos anunciados (ASIN/SKU) del tenant con métricas del periodo. Paginado.
- get_ads_advisor_recommendations (ads:read): Devuelve recomendaciones del Amazon Ads Advisor (pujas, negativas, scale, etc.).
- get_ads_campaign_detail (ads:read): Detalle slim de una campaña Ads: métricas, serie diaria corta y productos anunciados.
- get_ads_campaign_impact_series (ads:read): Serie diaria de rendimiento de una campaña (spend, sales, ACOS, CTR, CPC, CVR) + markers.
- get_ads_campaign_logbook (ads:read): Bitácora de cambios y decisiones de una campaña Ads.
- get_ads_campaign_settings (ads:read): Configuración vigente de una campaña: presupuesto, estrategia de puja, ajustes TOP/PP/ROS (%), ad groups (default bid) y keywords (bid/state).
- get_ads_campaign_targeting (ads:read): Targeting / rendimiento de una campaña: keywords, search terms, placements TOP/PP/ROS, ad groups o targets (product/category/auto). Paginado por sección.
- get_ads_campaigns (ads:read): Lista campañas Ads / PPC / anuncios con métricas (gasto, ventas, ACOS, ROAS, CPC, CTR, CVR).
- get_ads_pending_actions (ads:read): Lista acciones PPC pendientes de aprobación humana en Selleriva.
- get_ads_search_term_actions (ads:read): Devuelve acciones puntuadas de search terms (negativas, promote-to-exact, review bid).
- get_ads_summary (ads:read): KPIs agregados de Ads / PPC / anuncios del tenant (gasto, ventas, ACOS, ROAS) + decisiones recientes.
- get_keyword_rank (ads:read): Keyword 360 slim: posición SERP (serie 14d), Exacta, PPC 7d, competidores y recomendación.
- get_organic_ranks (ads:read): Señales de rank orgánico SERP por país (puesto + Exacta asociada).
Propose
- propose_ads_action (ads:propose): Crea una card en Selleriva → Ads → Automatización para que el usuario apruebe. NO escribe en Amazon Ads. Si solo describes la recomendación en el chat, NO llega a la app: DEBES llamar esta tool.
- propose_cost_update (cogs:propose): Propone un cambio de COGS / unit_cost para aprobación humana en SellerIVA → Costes. NO escribe el coste hasta que el usuario apruebe la propuesta.
- propose_purchase_order (inventory:propose): Crea un pedido a proveedor en estado Draft (source=mcp) a partir de un restock sugerido. NO envía a Amazon ni cambia el status del PO. El usuario lo ve en Pedidos y lo confirma.
- propose_weekly_action (ads:propose): Traduce una quick action de acciones semanales (/actions) a cards pending de Ads. Nunca escribe en Amazon Ads API ni llama /actions/execute.