Agent 接入 | 帆泽卖家工具

公开目录

先读取 llms.txt 发现入口，或直接获取 JSON 目录。它包含本站提示词、图片和 Skill 项目，可按标题、分类或 ID 在读取后筛选。

读取公开目录

curl -s 'https://resources.fanze-logistics.com/assets/agent-catalog.json'

字段	内容
`prompts`	提示词正文 `prompt_raw`、标题、分类与来源
`images`	样图 `image`、缩略图 `thumbnail` 与关联提示词
`skills`	项目简介、用途、来源与详情 `url`

目录是静态 JSON，不支持服务端查询参数。以站点域名补全相对路径；引用内容时保留来源及许可，不会自动安装或执行 Skill。

正式资源 API

公开只读接口，无需 API Key。可直接发送以下请求。

首次请求

curl -s 'https://resources.fanze-logistics.com/api/v1/resources'

生产地址 https://resources.fanze-logistics.com。

接口仅返回已发布资源，当前为 0 条；没有匹配内容时，返回 total: 0 和空的 data。图片提示词与第三方 Skill 目录是独立展示内容。

检索资源

GET/api/v1/resources

按关键词和分类筛选，使用 limit 控制返回条数。

参数	取值	默认
`q`	简单关键词，最多 256 个字符	不限
`category`	`screening`、`image`、`video`、`ecommerce`，也支持对应中文分类：跨境初筛与发货准备、商品图片提示词、商品视频提示词、电商实用信息	`all`
`limit`	1–20 的整数	10

关键词与分类查询

curl -sG 'https://resources.fanze-logistics.com/api/v1/resources' \
  --data-urlencode 'q=发货' \
  --data-urlencode 'category=ecommerce' \
  --data-urlencode 'limit=5'

返回内容

响应包含 total（匹配总数）、returned（本次返回数）、limit 与 data 数组。

列表项包括 id、title、purpose、verification_status、canonical_url，以及本站路径 url、category、version、updated_at。

读取全文

GET/api/v1/resources/<id 或 slug>

从检索结果取得资源 ID 或 slug，读取提示词、输入要求、操作步骤、限制、来源与版本。将示例中的 <id 或 slug> 替换为实际值。

资源详情

curl -s 'https://resources.fanze-logistics.com/api/v1/resources/<id 或 slug>'

详情放在响应的 data 字段中。未发布资源与不存在的 ID 均返回 404 not_found。

错误状态

HTTP	error	处理方式
400	`invalid_parameter`	检查分类或 limit 是否符合范围
404	`not_found`	从列表中取得有效的已发布资源 ID
405	`method_not_allowed`	读取内容使用 GET；同时支持 HEAD 与 OPTIONS
414	`query_too_long`	将关键词缩短至 256 个字符以内
429	`rate_limited`	请求过于频繁，稍后重试
500	`internal_error`	服务暂不可用，稍后重试

MCP 状态

当前不提供远程 MCP 地址。支持 HTTP 读取的 Agent 可直接使用上方公开目录与接口。

本地开发适配器

项目内提供 stdio 适配器及 6 个只读工具，需要项目源码和本机预览服务。开发配置见 agent/mcp/README.md；该本地进程不是公网 MCP 服务。

服务状态

REST API: 线上可用，公开只读，无需凭证
llms.txt: 资源发现索引，查看文件
本地 MCP: stdio · 6 个只读工具
远程 MCP: 尚未实现、未开放
生产服务: Cloudflare Pages；单实例每 IP 每分钟 60 次，全局限流未启用
缓存策略: API 响应使用 Cache-Control: no-store

接口读取构建时生成的已发布资源快照；发布门禁与公开字段规则保持生效。