AI-Native 小家电供应链数据

小家电供应链数据痛点

佛山小家电产业链年产值超千亿，但供应链数据仍然分散、低效、不可信。FS-HomeApp Data 以AI原生架构逐一击破。

传统 vs AI-Native 对比

什么是 AI-Native 供应链数据

AI-Native 供应链数据是为AI Agent和智能系统原生设计的数据基础设施。与传统数据库不同，它不仅仅是数据的存储，而是包含语义理解、关系图谱、实时流式和实验室验证的完整数据智能层。

以下是一个典型的小家电供应商JSON示例，展示了我们数据的深度和结构：

{
  "id": "sup-7f2c4a1b",
  "company_name": {
    "zh": "广东美的厨房电器制造有限公司",
    "en": "Guangdong Midea Kitchen Appliances Manufacturing Co., Ltd."
  },
  "registration": {
    "credit_code": "9144060678******",
    "registered_capital": "150000000",
    "established_date": "2005-08-12",
    "status": "active"
  },
  "contact": {
    "address": "广东省佛山市顺德区北滘镇美的大道6号",
    "phone": "+86-757-2633****",
    "website": "https://www.midea.com"
  },
  "capability": {
    "annual_output_units": 5000000,
    "production_lines": 18,
    "main_products": ["电磁炉", "电饭煲", "空气炸锅", "破壁机"],
    "certifications": ["CCC", "UL", "CE", "CB", "ISO 9001", "ISO 14001"],
    "r_and_d_staff": 320
  },
  "supply_chain": {
    "distributors": [
      {"name": "佛山华美电器贸易有限公司", "tier": "金牌"},
      {"name": "广州小家电进出口有限公司", "tier": "银牌"}
    ],
    "lead_time_days": 14,
    "port_of_loading": "深圳蛇口港"
  },
  "lab_tests": [
    {
      "product": "电磁炉",
      "test_standard": "GB/T 4706.29",
      "power_rating_w": 2200,
      "measured_power_w": 2185,
      "noise_db": 48,
      "safety_result": "PASS",
      "emc_result": "PASS"
    }
  ],
  "metadata": {
    "confidence": 0.96,
    "source": "工商注册+实地核验+实验室检测",
    "verified_at": "2026-04-20",
    "provenance": [
      "国家企业信用信息公示系统",
      "第三方现场审计",
      "实验室检测报告（GB/T 4706）"
    ]
  }
}

数据覆盖范围

深耕佛山小家电产业带，构建最完整的小家电供应链数据图谱

供应商分类

产品品类

涵盖佛山小家电全品类，包括但不限于：

产业集群

实验室检测项目

身份认证

所有API请求需通过 X-API-Key 头部传递API密钥。密钥分为三个层级：

MCP服务器

FS-HomeApp Data 提供原生 MCP (Model Context Protocol) 服务器，任何支持MCP的AI Agent（Claude、Cursor、Windsurf、Continue等）均可秒级接入，无需胶水代码或定制工具。

ChatGPT Actions

FS-HomeApp Data 兼容 ChatGPT Actions / GPTs 规范。将以下OpenAPI规范URL填入ChatGPT自定义GPT的Actions配置中，即可让ChatGPT直接查询小家电供应链数据：

.well-known/openapi.json

支持的功能包括供应商查询、产品检索、产业分析、价格趋势等，ChatGPT将自动根据用户意图调用对应接口。

定价

透明的按需定价，从免费到企业级灵活扩展：

查看完整定价：定价页

错误码

频率限制

所有API端点均实施速率限制，超额请求返回 429 Too Many Requests。限制策略如下：

响应格式

所有API响应均采用 application/json 格式，超过1KB的载荷启用 Content-Encoding: gzip 压缩。标准响应结构如下：

{
  "success": true,
  "data": { ... },
  "pagination": {
    "page": 1,
    "per_page": 20,
    "total": 1562,
    "total_pages": 79
  },
  "meta": {
    "request_id": "req-abc123",
    "timestamp": "2026-05-25T08:30:00Z",
    "latency_ms": 42
  }
}

OpenAPI规范

FS-HomeApp Data 提供完整的 OpenAPI 3.1 规范文档，支持自动生成客户端SDK和API文档浏览：

• 在线浏览：Swagger UI
• JSON规范：.well-known/openapi.json
• YAML规范：.well-known/openapi.yaml

供应商 (Suppliers)

供应商数据API，覆盖工商信息、产能、资质、供应链网络等63+维度。

产品 (Products)

集群 (Clusters)

产业集群API，查询佛山及周边产区产业分布、规模统计与关联分析。

分析 (Analytics)

发现 (Discovery)

智能发现API，基于语义理解与知识图谱，自动发现供应商、产品与市场机会。

账户 (Account)

系统 (System)

Python SDK

快速安装：

pip install fshomeapp-data

from fshomeapp_data import FSHomeAppClient

client = FSHomeAppClient(api_key="YOUR_API_KEY")
# 搜索佛山小家电供应商
suppliers = client.search_suppliers(
    product="电磁炉",
    cluster="顺德",
    limit=10
)
for s in suppliers:
    print(f"{s.company_name.zh} — {s.capability.annual_output_units}台/年")

Node.js SDK

npm install fshomeapp-data

import { FSHomeAppClient } from 'fshomeapp-data';

const client = new FSHomeAppClient({ apiKey: 'YOUR_API_KEY' });
const products = await client.searchProducts({
  category: '空气炸锅',
  minPower: 1200,
  cert: 'CCC'
});
console.log(products);

Go SDK

go get github.com/zdaios/fshomeapp-data-go

package main

import (
    "fmt"
    fshomeapp "github.com/zdaios/fshomeapp-data-go"
)

func main() {
    client := fshomeapp.NewClient("YOUR_API_KEY")
    clusters, _ := client.ListClusters("顺德")
    for _, c := range clusters {
        fmt.Printf("%s — %d家供应商\n", c.Name, c.SupplierCount)
    }
}

CLI 命令行工具

安装后即可在终端中查询小家电供应链数据：

npm install -g @zdaios/fshomeapp-cli

# 搜索供应商
fshomeapp suppliers --product "电饭煲" --cluster "北滘" --limit 5

# 查看产品详情
fshomeapp product get prod-abc123

# 列出集群
fshomeapp clusters --region "佛山"

快速开始

30秒内获取第一个查询结果：

curl -s /homeapp-supply-chain/api/v2/suppliers \
  -H "X-API-Key: YOUR_API_KEY" \
  -G -d "product=电磁炉" -d "cluster=顺德" -d "limit=3" | jq .

或使用Python MCP SDK：

from fshomeapp_mcp import FSHomeAppMCP

client = FSHomeAppMCP(api_key="YOUR_API_KEY")
suppliers = client.search_suppliers("佛山 小家电 空气炸锅 出口")
for s in suppliers:
    print(f"{s.company_name.zh} — 年产能: {s.capability.annual_output_units}台")