关于 twig
Twig 是用于评估和改进 MCP 服务、A2A Agent Card 等描述的命令行工具与托管 API。它按意图匹配度、具体性和差异化评分,并生成改写方案,另提供付费监测与竞争分析。
主要功能
- 01从三个维度评估描述
- 02生成三种优化描述版本
- 03每周监测评分与定位变化
- 04比较类别排名和意图趋势
- 05衡量描述调整与 x402 收入变化
适用场景
- 01发布前检查 MCP 服务的工具描述
- 02根据 Agent 查询趋势更新描述
- 03跟踪服务在类别中的竞争位置
- 04比较优化描述与 x402 收入变化
MCP 相关
Twig 通过读取 JSON-RPC tools/list 分析 MCP 服务,也支持其他来源。其托管 API 可接收 MCP 服务 URL 进行分析;它是分析工具,不是向客户端提供业务工具的服务端。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
Twig
Agent 会不会选择你,由它们说了算。Twig 让它们选择你。
Kindling 的一部分 — 面向 Agent 经济的 Agent SEO。
免费审计。付费监控。高级情报。
| 等级 | 功能 | 价格 |
|---|---|---|
| Free | twig analyze — 为你的描述评分。twig optimize — 获取更优版本。 | 永久免费 |
| Monitor | 每周重新评分、竞争位置、意图趋势提醒 | 每份报告 $0.50–2.00,通过 x402 付费 |
| Intelligence | 类别基准、意图语料库、竞争指数 | 每次查询 $0.50–1.00,通过 x402 付费 |
| Enterprise | 经衡量的 x402 收入增幅的 15% | 按效果计费;没有提升则零费用 |
问题
每个 MCP 工具都有描述。大模型在决定是否调用你的服务时会读取这段描述。它是“被选中”和“被跳过”之间唯一的信号。
大多数描述都糟糕透顶。
| 工具 | 当前描述 | Twig 评分 |
|---|---|---|
exa/answer | “AI 驱动的回答” | F (28/100) |
wordspace/invoke | “运行 wordspace AI Agent 循环” | F (31/100) |
exa/find-similar | “查找相似页面” | F (33/100) |
jupiter/portfolio | “钱包投资组合持仓” | D (42/100) |
这些工具很有用,但它们的描述并非如此。即使你被收录到 x402-discovery 或 MCPay,如果 Agent 看不出你的用途而跳过你,收录也毫无帮助。
被收录只是入场门槛。Twig 帮你获得选择。
快速开始
npm install -g @kind-ling/twig
# Free — score your descriptions
twig analyze https://myservice.com/.well-known/agent.json
# Free — get optimized variants
twig optimize https://myservice.com/.well-known/agent.json
# Paid — set up weekly monitoring
twig monitor https://myservice.com/.well-known/agent.json
# Paid — see how you rank in your category
twig competitive crypto-defi
# Paid — see what agents are actually searching for
twig intents crypto-defi
在线 API
Twig 提供托管 API,地址为 https://twig.kind-ling.com
# Health check
curl https://twig.kind-ling.com/health
# Analyze any MCP server
curl -X POST https://twig.kind-ling.com/analyze \
-H "Content-Type: application/json" \
-d '{"url": "https://your-mcp-server.com/mcp"}'
# Optimize descriptions
curl -X POST https://twig.kind-ling.com/optimize \
-H "Content-Type: application/json" \
-d '{"url": "https://your-mcp-server.com/mcp", "category": "crypto-defi"}'
响应格式:
{
"ok": true,
"url": "https://your-mcp-server.com/mcp",
"output": "🔍 Analyzing...\n Score: 72/100 (C)\n ..."
}
公共端点无需 API 密钥。请求频率限制适用。
评分模型
三个维度,每项 0–100 分:
| 维度 | 权重 | 衡量内容 |
|---|---|---|
| 意图匹配度 | 40% | 与该类别热门 Agent 查询的相似度 |
| 具体程度 | 35% | 是否包含输出格式、参数、限制和示例? |
| 差异化程度 | 25% | 你是否在同类别的类似服务中脱颖而出? |
等级: A (85+) · B (70+) · C (55+) · D (40+) · F (<40)
低于 40 分 = Agent 会跳过你。
Twig 监控的内容
你的描述 — 每周与实时意图语料库进行比对并重新评分。评分变化会在你的定位发生偏移时提醒你。
你的竞争位置 — 你在同类别类似服务中的排名。了解竞争对手何时提升并超越你。
意图趋势 — Agent 本周与上周搜索内容的变化。查询会不断变化,你的描述也需要跟上。
流量相关性 — 将描述变化与 x402 流量变化对应起来,打通优化与收入之间的反馈闭环。
优化版本
Twig 为每个工具生成 3 个版本:
功能型 — 动作动词 + 功能 + 返回类型:
“使用实时网页来源回答问题。返回附有来源 URL、置信度评分和佐证引文的回答。适用于研究和事实核查。”
结构型 — 输入 → 输出及限制:
“网页问答。输入:问题字符串。返回:答案(字符串)、来源(URL 数组)、置信度(0–1)。支持:事实查询、时事、研究综合。”
场景型 — 使用场景 → 动作 → 输出(最容易被大模型选中):
“需要附有来源引用的事实性答案时使用。实时搜索网页,并综合生成附有 URL 和佐证引文的回答。适用于研究、事实核查和时事。”
优化前 / 优化后
exa/answer
之前: AI-powered answer ← F (28/100)
之后(上下文式): Use when you need a factual answer with sourced citations. Queries the web in real-time and synthesizes a response with source URLs and supporting quotes. Best for research, fact-checking, and current events. ← B (72/100)
wordspace/invoke
之前: Run wordspace AI agent loop ← F (31/100)
之后(结构化): Executes a Wordspace multi-step agent workflow. Input: task description and optional context. Returns: completed output, intermediate steps, tool calls made. Best for complex tasks requiring multiple tool invocations. $2/call. ← B (74/100)
收益模式
标准版(监控)
每周报告通过 Base 上的 x402 进行门控。设置一次,即可自动运行。
twig monitor 0xYourWallet --url https://myservice.com/.well-known/agent.json
企业版(基于成效)
适用于已有 x402 交易量的服务:
twig measure 0xWallet --baseline— 记录 7 天基线- 部署经 Twig 优化的描述
twig measure 0xWallet --compare— 衡量差值(14–30 天后)- 在 Base 上以 USDC 支付收入增量的 15%
- 收入持平或下降?无需付费。
所有数据均通过链上 USDC 转账日志衡量。无需自行报告。
支持的来源
- A2A Agent 卡片(
/.well-known/agent.json) - MCP 服务(JSON-RPC
tools/list) - OpenAPI 规范
- 本地 JSON schema 文件
- x402-discovery 目录(用于竞争分析)
CLI 参考
twig analyze <url> Score descriptions (0-100, free)
twig optimize <url> Generate 3 optimized variants (free)
twig monitor <url> Weekly monitoring (paid via x402)
twig competitive <category> Category ranking (paid via x402)
twig intents <category> Top agent queries (paid via x402)
twig measure <wallet> Measure x402 revenue
twig measure <wallet> --baseline Save baseline
twig measure <wallet> --compare Compare to baseline
twig report <wallet> Revenue report with fee calculation
Categories: crypto-defi, data-feeds, research, computation, media, communication, general
Twig v0.1.0 · Kind-ling · Permanent Upper Class · MIT
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。