{
  "report": {
    "title": "Mercado Livre 店铺日报",
    "subtitle": "基于 Mercado Livre OAuth 与本地 MCP 工具链生成的店铺运营快照",
    "avatar_url": "/mercado_livre_logo.jpg",
    "store_name": "VV20250606103344",
    "seller_id": 2479210635,
    "advertiser_id": null,
    "report_date": "2026-09-05",
    "timezone": "Asia/Shanghai",
    "last_updated": "2026-09-05 19:47:21"
  },
  "source_contract": {
    "mcp_server": "mercado-livre-mlb-mcp",
    "base_path": "/opt/mercado-livre-mlb-mcp",
    "aligned_tools": [
      "list_seller_items",
      "get_order_details",
      "list_received_buyer_messages",
      "list_buyer_questions",
      "get_item_metrics",
      "get_advertising_data",
      "get_ads_campaign_dashboard",
      "answer_buyer_question",
      "get_seller_reputation",
      "find_competitor_products",
      "get_category_attributes",
      "get_catalog_competition_price",
      "get_item_price_history",
      "search_products",
      "get_item_details"
    ],
    "conditional_tools": [
      "answer_buyer_question",
      "get_item_metrics",
      "get_catalog_competition_price",
      "get_item_price_history",
      "get_advertising_data",
      "get_ads_campaign_dashboard"
    ],
    "missing_tools": []
  },
  "summary": {
    "seller_items_count": 19,
    "orders_count": null,
    "buyer_messages_count": 0,
    "buyer_questions_count": 2,
    "ads_campaigns_count": 0,
    "ads_total_investment": null,
    "ads_total_revenue": null
  },
  "capability_matrix": [
    {
      "name": "商品与刊登清单",
      "tool_name": "list_seller_items",
      "endpoint": "GET /users/{seller_id}/items/search or /sites/MLB/search?seller_id=...",
      "description": "拉取卖家上架商品列表，支持公开模式与私有模式。",
      "status": "implemented",
      "auth": "public or seller token",
      "tags": [
        {
          "text": "implemented",
          "className": "success"
        },
        {
          "text": "items",
          "className": "info"
        },
        {
          "text": "public/private",
          "className": "neutral"
        }
      ]
    },
    {
      "name": "订单详情",
      "tool_name": "get_order_details",
      "endpoint": "GET /orders/{order_id}",
      "description": "拉取订单、付款与可选物流详情。",
      "status": "implemented",
      "auth": "seller token",
      "tags": [
        {
          "text": "implemented",
          "className": "success"
        },
        {
          "text": "orders",
          "className": "info"
        },
        {
          "text": "auth required",
          "className": "warning"
        }
      ]
    },
    {
      "name": "售后消息",
      "tool_name": "list_received_buyer_messages",
      "endpoint": "GET /messages/{resource_type}/{resource_id}",
      "description": "按订单或 pack 拉取买家消息流。",
      "status": "implemented",
      "auth": "seller token",
      "tags": [
        {
          "text": "implemented",
          "className": "success"
        },
        {
          "text": "messages",
          "className": "info"
        },
        {
          "text": "auth required",
          "className": "warning"
        }
      ]
    },
    {
      "name": "售前问题",
      "tool_name": "list_buyer_questions",
      "endpoint": "GET /questions/search",
      "description": "按 seller 或 item 拉取买家提问，并可按状态与时间过滤。",
      "status": "implemented",
      "auth": "seller token",
      "tags": [
        {
          "text": "implemented",
          "className": "success"
        },
        {
          "text": "questions",
          "className": "info"
        },
        {
          "text": "auth required",
          "className": "warning"
        }
      ]
    },
    {
      "name": "回复售前问题",
      "tool_name": "answer_buyer_question",
      "endpoint": "POST /answers",
      "description": "提交对买家问题的回复，可用于日报中的待处理动作。",
      "status": "implemented",
      "auth": "seller token",
      "tags": [
        {
          "text": "implemented",
          "className": "success"
        },
        {
          "text": "action",
          "className": "info"
        },
        {
          "text": "write operation",
          "className": "warning"
        }
      ]
    },
    {
      "name": "刊登指标与健康度",
      "tool_name": "get_item_metrics",
      "endpoint": "GET /items/{item_id}/visits/time_window and /items/{item_id}/health",
      "description": "聚合流量与刊登健康度信号，部分账号依赖受限分析权限。",
      "status": "implemented",
      "auth": "seller token",
      "tags": [
        {
          "text": "implemented",
          "className": "success"
        },
        {
          "text": "metrics",
          "className": "info"
        },
        {
          "text": "account dependent",
          "className": "warning"
        }
      ]
    },
    {
      "name": "店铺声誉",
      "tool_name": "get_seller_reputation",
      "endpoint": "GET /users/{seller_id}",
      "description": "读取卖家公开声誉、等级与基础资料。",
      "status": "implemented",
      "auth": "public",
      "tags": [
        {
          "text": "implemented",
          "className": "success"
        },
        {
          "text": "reputation",
          "className": "info"
        },
        {
          "text": "public",
          "className": "neutral"
        }
      ]
    },
    {
      "name": "竞品研究",
      "tool_name": "find_competitor_products",
      "endpoint": "GET /sites/MLB/search",
      "description": "按关键词或 catalog 商品查找竞品，并可排除自家 seller。",
      "status": "implemented",
      "auth": "public",
      "tags": [
        {
          "text": "implemented",
          "className": "success"
        },
        {
          "text": "competitors",
          "className": "info"
        },
        {
          "text": "public",
          "className": "neutral"
        }
      ]
    },
    {
      "name": "类目与属性要求",
      "tool_name": "get_category_attributes",
      "endpoint": "GET /categories/{category_id} and /categories/{category_id}/attributes",
      "description": "读取刊登类目的必填属性与技术属性要求。",
      "status": "implemented",
      "auth": "public",
      "tags": [
        {
          "text": "implemented",
          "className": "success"
        },
        {
          "text": "category",
          "className": "info"
        },
        {
          "text": "public",
          "className": "neutral"
        }
      ]
    },
    {
      "name": "Buy Box / 价格制胜信号",
      "tool_name": "get_catalog_competition_price",
      "endpoint": "GET /items/{item_id}/price_to_win and /products/{catalog_product_id}",
      "description": "拉取价格制胜信号与 catalog 竞争参考，部分信号依赖 token。",
      "status": "implemented",
      "auth": "public or seller token",
      "tags": [
        {
          "text": "implemented",
          "className": "success"
        },
        {
          "text": "pricing",
          "className": "info"
        },
        {
          "text": "partial access",
          "className": "warning"
        }
      ]
    },
    {
      "name": "价格历史",
      "tool_name": "get_item_price_history",
      "endpoint": "GET /items/{item_id}/price_history",
      "description": "追踪单商品历史调价轨迹，通常要求卖家 token。",
      "status": "implemented",
      "auth": "seller token",
      "tags": [
        {
          "text": "implemented",
          "className": "success"
        },
        {
          "text": "price history",
          "className": "info"
        },
        {
          "text": "auth required",
          "className": "warning"
        }
      ]
    },
    {
      "name": "广告活动列表",
      "tool_name": "get_advertising_data",
      "endpoint": "GET /advertising/product_ads/campaigns or /items",
      "description": "拉取广告 campaign 或 item 维度数据。",
      "status": "implemented",
      "auth": "mercado ads token",
      "tags": [
        {
          "text": "implemented",
          "className": "success"
        },
        {
          "text": "ads",
          "className": "info"
        },
        {
          "text": "ads permission",
          "className": "warning"
        }
      ]
    },
    {
      "name": "广告 Dashboard 归一化",
      "tool_name": "get_ads_campaign_dashboard",
      "endpoint": "GET /advertising/product_ads/campaigns/{campaign_id} and metrics/report",
      "description": "把官方广告字段标准化为日报表格可直接显示的列。",
      "status": "implemented",
      "auth": "mercado ads token",
      "tags": [
        {
          "text": "implemented",
          "className": "success"
        },
        {
          "text": "normalized",
          "className": "info"
        },
        {
          "text": "ads permission",
          "className": "warning"
        }
      ]
    }
  ],
  "seller_items": {
    "tool": "list_seller_items",
    "input": {
      "seller_id": 2479210635,
      "include_private": true,
      "status": "active",
      "limit": 50,
      "offset": 0
    },
    "response": {
      "results": [
        "MLB6009815824",
        "MLB4346710467",
        "MLB4346710033",
        "MLB4346709573",
        "MLB4346671971",
        "MLB4346671467",
        "MLB4346670109",
        "MLB4346658027",
        "MLB4346620059",
        "MLB4346618777",
        "MLB7325255682",
        "MLB4989573277",
        "MLB7334072018",
        "MLB7334036714",
        "MLB4996350475",
        "MLB7382744072",
        "MLB7382744068",
        "MLB7382403200",
        "MLB7405249160"
      ],
      "paging": {
        "limit": 50,
        "offset": 0,
        "total": 19
      },
      "raw": null
    }
  },
  "orders": {
    "tool": "get_order_details",
    "note": "订单详情需要按具体 order_id 拉取；当前日报先展示商品累计销量字段，后续可接订单搜索/订单列表来源。",
    "by_item": [
      {
        "item_id": "MLB6009815824",
        "item_title": "Roborock Q10 Robô Aspirador Escova Principal De Borracha Vermelho",
        "item_status": "active",
        "orders_count": null,
        "units_sold": 6,
        "revenue": 414.0,
        "order_ids": []
      },
      {
        "item_id": "MLB4346710467",
        "item_title": "Roborock Qr 598 Esfregona Antibacteriana 4pcs",
        "item_status": "active",
        "orders_count": null,
        "units_sold": 12,
        "revenue": 828.0,
        "order_ids": []
      },
      {
        "item_id": "MLB4346710033",
        "item_title": "Roborock Q10série Robô Aspirador Acessórios Para Filtra 2pcs",
        "item_status": "active",
        "orders_count": null,
        "units_sold": 10,
        "revenue": 690.0,
        "order_ids": []
      },
      {
        "item_id": "MLB4346709573",
        "item_title": "Roborock S5a/598 Robô Aspirador Acessórios Para Filtra 2pcs",
        "item_status": "active",
        "orders_count": null,
        "units_sold": 4,
        "revenue": 276.0,
        "order_ids": []
      },
      {
        "item_id": "MLB4346671971",
        "item_title": "Roborock Q10 Vf+ Robô Aspirador Peças Para Caixa De Pó 3pcs",
        "item_status": "active",
        "orders_count": null,
        "units_sold": 11,
        "revenue": 759.0,
        "order_ids": []
      },
      {
        "item_id": "MLB4346671467",
        "item_title": "Roborock Edge S5a Robô Aspirador Esfregão Antibacteriano 4pc",
        "item_status": "active",
        "orders_count": null,
        "units_sold": 10,
        "revenue": 690.0,
        "order_ids": []
      },
      {
        "item_id": "MLB4346670109",
        "item_title": "Roborock Robô Aspirador Acessório Para Escova Lateral 2pcs",
        "item_status": "active",
        "orders_count": null,
        "units_sold": 21,
        "revenue": 1449.0,
        "order_ids": []
      },
      {
        "item_id": "MLB4346658027",
        "item_title": "Roborock Sérieq10 Robô Aspirador Acessórios De Esfregão 2pcs",
        "item_status": "active",
        "orders_count": null,
        "units_sold": 8,
        "revenue": 552.0,
        "order_ids": []
      },
      {
        "item_id": "MLB4346620059",
        "item_title": "Roborock Qr 598 Robô Aspirador Escova Principal De Borracha",
        "item_status": "active",
        "orders_count": null,
        "units_sold": 5,
        "revenue": 345.0,
        "order_ids": []
      },
      {
        "item_id": "MLB4346618777",
        "item_title": "Roborock Edges5a Robô Aspirador Escova Principal De Borracha",
        "item_status": "active",
        "orders_count": null,
        "units_sold": 5,
        "revenue": 345.0,
        "order_ids": []
      },
      {
        "item_id": "MLB7325255682",
        "item_title": "MLB7325255682",
        "item_status": "-",
        "orders_count": null,
        "units_sold": 0,
        "revenue": 0.0,
        "order_ids": []
      },
      {
        "item_id": "MLB4989573277",
        "item_title": "MLB4989573277",
        "item_status": "-",
        "orders_count": null,
        "units_sold": 0,
        "revenue": 0.0,
        "order_ids": []
      },
      {
        "item_id": "MLB7334072018",
        "item_title": "MLB7334072018",
        "item_status": "-",
        "orders_count": null,
        "units_sold": 0,
        "revenue": 0.0,
        "order_ids": []
      },
      {
        "item_id": "MLB7334036714",
        "item_title": "MLB7334036714",
        "item_status": "-",
        "orders_count": null,
        "units_sold": 0,
        "revenue": 0.0,
        "order_ids": []
      },
      {
        "item_id": "MLB4996350475",
        "item_title": "MLB4996350475",
        "item_status": "-",
        "orders_count": null,
        "units_sold": 0,
        "revenue": 0.0,
        "order_ids": []
      },
      {
        "item_id": "MLB7382744072",
        "item_title": "MLB7382744072",
        "item_status": "-",
        "orders_count": null,
        "units_sold": 0,
        "revenue": 0.0,
        "order_ids": []
      },
      {
        "item_id": "MLB7382744068",
        "item_title": "MLB7382744068",
        "item_status": "-",
        "orders_count": null,
        "units_sold": 0,
        "revenue": 0.0,
        "order_ids": []
      },
      {
        "item_id": "MLB7382403200",
        "item_title": "MLB7382403200",
        "item_status": "-",
        "orders_count": null,
        "units_sold": 0,
        "revenue": 0.0,
        "order_ids": []
      },
      {
        "item_id": "MLB7405249160",
        "item_title": "Aspirador De Pó Vertical Sem Fio Seco Úmido Redroad W15 200w Branco 127/220v",
        "item_status": "active",
        "orders_count": null,
        "units_sold": 33,
        "revenue": 65967.0,
        "order_ids": []
      }
    ]
  },
  "buyer_messages": {
    "tool": "list_received_buyer_messages",
    "note": "按订单或 pack 拉取的售后消息原样落地，页面仅做展示汇总。",
    "resources": []
  },
  "buyer_questions": {
    "tool": "list_buyer_questions",
    "status": "ready",
    "missing_tool": null,
    "note": "已通过 Mercado Livre OAuth 读取当前在售商品对应的未回复售前问题；已排除已回复问题和非在售商品问题。",
    "items": [
      {
        "product": "Redroad W15",
        "sku": "10032110125",
        "mercado_livre_item_id": "MLB7405249160",
        "raw_status": "UNANSWERED",
        "status": "未回复",
        "date_created": "2026-09-05 06:04",
        "text": "Esta falando que minha compra esta sendo processada! Oque seria isso ?"
      },
      {
        "product": "Redroad W15",
        "sku": "10032110125",
        "mercado_livre_item_id": "MLB7405249160",
        "raw_status": "UNANSWERED",
        "status": "未回复",
        "date_created": "2026-09-05 07:24",
        "text": "Olá onde compro oi s acessórios para o aspirador vertical 3 em 2"
      }
    ]
  },
  "item_metrics": {
    "tool": "get_item_metrics",
    "items": []
  },
  "advertising": {
    "campaign_list": {
      "tool": "get_advertising_data",
      "input": {
        "advertiser_id": null,
        "campaign_id": null,
        "item_id": null,
        "date_from": "2026-08-27",
        "date_to": "2026-08-27",
        "limit": 50,
        "offset": 0
      },
      "response": {
        "results": [],
        "paging": null,
        "raw": null
      }
    },
    "campaign_dashboards": {
      "tool": "get_ads_campaign_dashboard",
      "items": []
    }
  },
  "market_signals": {
    "competition_signals_count": 4,
    "competition_status": "ready",
    "price_history_status": "implemented but token dependent",
    "item_metrics_status": "token ready",
    "pricing": {
      "coverage": "price_to_win + history",
      "price_to_win_status": "implemented",
      "history_status": "implemented but token dependent",
      "note": "价格监控可结合 get_catalog_competition_price 与 get_item_price_history；当前 JSON 仍未落地具体 item 样本。"
    },
    "competitor_research": {
      "scope": "keyword or catalog item",
      "status": "implemented",
      "sample_count": 0,
      "note": "OAuth 已接入；竞品关键词确定后可加入每日 search_products / find_competitor_products 样本。"
    },
    "listing_quality": {
      "coverage": "traffic + category attributes",
      "metrics_status": "token ready",
      "category_status": "implemented",
      "note": "刊登质量由 get_item_metrics 与 get_category_attributes 组合提供，页面已准备展示位。"
    },
    "seller_reputation": {
      "status": "ready",
      "level": "5_green",
      "scope": "seller-level",
      "note": "店铺 VV20250606103344 当前声誉等级 5_green，交易统计 total=963, completed=861。"
    }
  },
  "timeline": [
    {
      "date": "2026-09-05",
      "title": "Mercado Livre OAuth 接入",
      "description": "完成授权码换 token、自动刷新、MCP token 文件读取和店铺日报真实数据刷新。"
    },
    {
      "date": "2026-09-05",
      "title": "Mercado Livre OAuth 接入",
      "description": "完成授权码换 token、自动刷新、MCP token 文件读取和店铺日报真实数据刷新。"
    },
    {
      "date": "2026-09-05",
      "title": "Mercado Livre OAuth 接入",
      "description": "完成授权码换 token、自动刷新、MCP token 文件读取和店铺日报真实数据刷新。"
    },
    {
      "date": "2026-09-05",
      "title": "Mercado Livre OAuth 接入",
      "description": "完成授权码换 token、自动刷新、MCP token 文件读取和店铺日报真实数据刷新。"
    }
  ],
  "notes": [
    {
      "type": "system",
      "title": "OAuth 已接入",
      "content": "服务器已保存 Mercado Livre access_token/refresh_token，并通过 systemd timer 每 30 分钟检查刷新。"
    },
    {
      "type": "system",
      "title": "真实账号验证",
      "content": "/users/me 验证通过，seller_id=2479210635，nickname=VV20250606103344，site_id=MLB。"
    },
    {
      "type": "warning",
      "title": "订单与广告待补数据源",
      "content": "商品和买家问题已落地。订单详情仍需要具体 order_id 或订单列表来源；广告数据需要确认 advertiser_id。"
    }
  ]
}