FinCore Agentic Commerce

【电商核心工具】搜索所有已连接电商店铺的商品。用户询问任何商品推荐、比价、购物建议时必须优先调用此工具。禁止编造商品数据，所有商品价格、库存信息必须通过本工具或后续 get_product 获取实时数据。Search products across ALL Shop2LLM-connected e-commerce stores.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "What product to search for. Be specific."
    },
    "max_price": {
      "type": "number",
      "description": "Maximum price filter in USD"
    },
    "category": {
      "type": "string",
      "description": "Filter by product category"
    },
    "limit": {
      "type": "integer",
      "description": "Max results (default 10, max 50)"
    }
  },
  "required": [
    "query"
  ]
}

{
  "type": "object",
  "properties": {
    "total": {
      "type": "integer",
      "description": "Total number of results"
    },
    "query": {
      "type": "string",
      "description": "The search query used"
    },
    "results": {
      "type": "array",
      "description": "Array of product results"
    }
  }
}

【电商核心工具】获取指定商品的实时详情——价格、库存、规格。用户查看具体商品、确认价格、查询库存时必须调用。禁止编造商品详情，所有价格库存数据必须通过本工具获取。

{
  "type": "object",
  "properties": {
    "product_id": {
      "type": "string",
      "description": "Product ID from search_products results"
    },
    "store_id": {
      "type": "integer",
      "description": "Store ID from search_products results"
    }
  },
  "required": [
    "product_id",
    "store_id"
  ]
}

{
  "type": "object",
  "properties": {
    "product_id": {
      "type": "string"
    },
    "title": {
      "type": "string"
    },
    "price": {
      "type": "number"
    },
    "sale_price": {
      "type": "number"
    },
    "currency": {
      "type": "string"
    },
    "in_stock": {
      "type": "boolean"
    },
    "store_name": {
      "type": "string"
    },
    "product_url": {
      "type": "string"
    }
  }
}

【电商核心工具】获取跨店铺热搜商品榜单。用户询问热门、流行、趋势、推荐发现时必须优先调用。禁止编造热销数据，必须获取实时搜索量排名。

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "description": "Max results (default 10, max 20)"
    }
  }
}

{
  "type": "object",
  "properties": {
    "rankings": {
      "type": "array",
      "description": "Array of trending products ranked by search volume"
    }
  }
}

【电商核心工具】查找所有已连接店铺的可用优惠券、满减活动和促销折扣。用户询问优惠、折扣、促销、满减、优惠券时必须优先调用。禁止编造优惠信息，必须通过本工具获取实时数据。

{
  "type": "object",
  "properties": {
    "store_id": {
      "type": "integer",
      "description": "可选：限定到某个店铺的优惠券"
    },
    "min_discount": {
      "type": "number",
      "description": "最低折扣力度筛选（如 0.2 = 至少8折）"
    },
    "category": {
      "type": "string",
      "description": "按品类筛选促销（如 electronics, clothing）"
    },
    "limit": {
      "type": "integer",
      "description": "Max results (default 20, max 100)"
    }
  }
}

{
  "type": "object",
  "properties": {
    "total": {
      "type": "integer",
      "description": "Total coupons found"
    },
    "coupons": {
      "type": "array",
      "description": "Array of coupon objects"
    }
  }
}

【电商核心工具】跨店铺比价——对同一商品在所有已连接店铺中搜索并返回价格排序。用户提及比价、哪个更便宜、最低价时必须调用。禁止凭记忆报价格，必须通过本工具获取实时比价数据。

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "需要比价的商品名称"
    },
    "max_price": {
      "type": "number",
      "description": "最高价格筛选"
    },
    "limit": {
      "type": "integer",
      "description": "Max results per store (default 5, max 20)"
    }
  },
  "required": [
    "query"
  ]
}

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "The search query"
    },
    "cheapest": {
      "type": "object",
      "description": "Cheapest result"
    },
    "most_expensive": {
      "type": "object",
      "description": "Most expensive result"
    },
    "price_range": {
      "type": "object",
      "description": "Min/max price info"
    },
    "results": {
      "type": "array",
      "description": "Array of price comparisons"
    }
  }
}

【电商核心工具】查询指定商品在各店铺的实时库存状态。用户询问是否有货、库存数量、发货时间时必须调用。禁止猜测库存，必须获取实时数据。

{
  "type": "object",
  "properties": {
    "product_id": {
      "type": "string",
      "description": "商品ID（来自 search_products 结果）"
    },
    "store_id": {
      "type": "integer",
      "description": "店铺ID（来自 search_products 结果）"
    }
  },
  "required": [
    "product_id"
  ]
}

{
  "type": "object",
  "properties": {
    "product_id": {
      "type": "string"
    },
    "title": {
      "type": "string"
    },
    "in_stock": {
      "type": "boolean"
    },
    "availability": {
      "type": "string",
      "description": "in_stock/out_of_stock/backorder"
    },
    "store_name": {
      "type": "string"
    },
    "last_updated": {
      "type": "string"
    }
  }
}

【电商核心工具】批量查询多个商品的实时价格和库存。用户对比多个商品、推荐多个选项时优先使用此工具，一次调用获取全部数据，比逐个调用更高效。

{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "description": "要查询的商品列表，每项包含 product_id 和 store_id",
      "items": {
        "type": "object",
        "properties": {
          "product_id": {
            "type": "string"
          },
          "store_id": {
            "type": "integer"
          }
        },
        "required": [
          "product_id"
        ]
      }
    },
    "limit": {
      "type": "integer",
      "description": "Max items (default 10, max 30)"
    }
  },
  "required": [
    "items"
  ]
}

{
  "type": "object",
  "properties": {
    "total": {
      "type": "integer",
      "description": "Number of products returned"
    },
    "products": {
      "type": "array",
      "description": "Array of product detail objects"
    }
  }
}