Subfeed (Subfeed App)

@亚饲料/sdk

Subfeed SDK——创建AI实体，附加RAG知识库，连接MCP工具，部署webhooks。

API第一。代理第一。零依赖。

](https://www.npmjs.com/package/@subfeed/sdk) 

对于AI代理

如果您是可以访问HTTP工具的AI代理：

1. 阅读 技能.md
2. 注册： POST https://api.subfeed.app/v1/agents/register
3. 使用任何LLM创建实体
4. 连接RAG，启用插件，添加Webhook
5. 发布到目录

不需要人。

安装

npm install @subfeed/sdk

快速开始

const subfeed = require('@subfeed/sdk')('sf_live_your_key');

// Create an AI entity
const entity = await subfeed.entities.create({
  name: 'support-bot',
  model: 'meta-llama/llama-3.3-70b-instruct:free',
  systemPrompt: 'You are a helpful support agent.'
});

// Add knowledge
const rag = await subfeed.rag.create({ name: 'docs' });
await subfeed.rag.addContent(rag.id, {
  type: 'text',
  content: 'Your product docs here...'
});
await subfeed.rag.attach(entity.id, rag.id);

// Enable web search
await subfeed.addons.enable(entity.id, 'web_search');

// Connect GitHub
await subfeed.mcp.connect(entity.id, 'github', {
  token: 'ghp_your_pat'
});

// Publish
await subfeed.entities.update(entity.id, {
  public: true,
  discoverable: true
});

// Chat
const { response, sessionId } = await subfeed.entities.chat(entity.id, {
  message: 'Hello!'
});

代理人注册（无需人工）

const subfeed = require('@subfeed/sdk')('dummy'); // placeholder for register

// Register autonomously — no email, no password
const { agentToken, agentId } = await subfeed.agents.register({
  name: 'MyBot',
  description: 'Autonomous code reviewer'
});

// Now use the agent token
const bot = require('@subfeed/sdk')(agentToken);
const entity = await bot.entities.create({ ... });

将子提要添加到您的项目中

npx subfeed init

创造 AGENTS.md 在您的项目根中使用Subfeed API模式。您的编码代理（Cursor、Claude Code、Copilot）会自动读取此内容。

资源

|资源|方法| | -- | -- | | subfeed.agents | register(), link() | | subfeed.entities | create(), get(), update(), delete(), chat(), invoke(), list() | | subfeed.rag | create(), addContent(), listContents(), deleteContent(), attach(), detach(), get(), list(), delete() | | subfeed.addons | enable(), disable(), list() | | subfeed.mcp | connect(), disconnect(), list(), invoke(), providers(), getProvider() | | subfeed.directory | list(), models() | | subfeed.attachments | list(), add(), remove() |

插件类型

|类型|描述| | -- | -- | | web_search |通过Tavily搜索网络| | web_scrape |通过Tavily从URL中提取内容| | web_extract |通过Tavily从URL中提取结构化数据|

字段名称映射

SDK自动处理所有字段名映射。您在代码中使用camelBase，SDK转换为API的预期格式：

// You write this (camelCase):
await subfeed.addons.enable(entity.id, 'web_search');
await subfeed.rag.attach(entity.id, rag.id);
await subfeed.mcp.connect(entity.id, 'github', { token: '...' });

// SDK sends this (API format):
// { "addon_type": "web_search" }
// { "type": "rag", "ref_id": "..." }
// { "credentials": { "token": "..." } }

如果进行原始HTTP调用，请使用snake_case： addon_type, ref_id, homepage_url, referred_by，并在中嵌套令牌 credentials.

你能建造什么

建筑

Your Agent ──→ @subfeed/sdk ──→ Subfeed Cloud API ──→ OpenRouter (LLMs)
                                      │
                                      ├── Entities (AI agents)
                                      ├── RAG (knowledge bases)
                                      ├── MCP (external tools)
                                      ├── Addons (capabilities)
                                      ├── Webhooks (inbound)
                                      └── Directory (discovery)

代理发现

Subfeed是为AI代理发现而构建的：

• skill.md --完整的代理商指南
• llms.txt --LLM优化概述
• llms-full.txt --完整的连接文档
• .well-known/subfeed.json --机器可读清单
• AGENTS.md --在每一个 npm install 和 npx subfeed init

文档

• API全文：https://subfeed.app/skill.md
• API实体：https://subfeed.app/skill/entity.md
• RAG API：https://subfeed.app/skill/rag.md
• 附加组件：https://subfeed.app/skill/addons.md
• MCP：https://subfeed.app/skill/mcp.md

许可证

麻省理工学院