fittings-doc-url-metadata

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

URL metadata and Open Graph tags

URL元数据与Open Graph标签

doc.url-metadata

https://fittings.sh

. One endpoint, web and network.

Fetch a public URL and return its title, description, preview image, site name and canonical URL from its meta tags.

doc.url-metadata

部署于

https://fittings.sh

。这是一个面向Web和网络的单一接口。

获取公开URL并从其元标签中返回标题、描述、预览图、站点名称和规范URL。

The call

调用

GET https://fittings.sh/v1/doc/url-metadata

Field	Type	Required	Notes
`url`	string	yes	Public http(s) URL

Example input:

json

{
  "url": "https://example.com/"
}

GET https://fittings.sh/v1/doc/url-metadata

字段	类型	是否必填	说明
`url`	string	是	公开的http(s) URL

示例输入：

json

{
  "url": "https://example.com/"
}

Metered

计量

The 402 quotes a ceiling — the price of the declared cap, 512000 bytes — and settlement is for what the call actually used. A small request settles for less than it was quoted, so read the quote as an upper bound rather than a price.

402响应会给出一个上限价格——即声明的上限（512000字节）对应的价格，而最终结算则按照调用实际使用的字节数计算。小请求的结算金额会低于报价，因此请将报价视为上限而非固定价格。

Cost and provenance

成本与来源


Price	$0.003 per call, metered per bytes
Source	live fetch of the caller-supplied URL
Licence	permissive
Attribution	Metadata belongs to the origin publisher


价格	每次调用0.003美元，按字节计量
来源	实时获取调用者提供的URL
许可证	宽松许可
归属	元数据归原始发布者所有

Why call it rather than answer from memory

为何调用该接口而非从内存返回

A publishing, chat or bookmarking agent asked to render a link preview needs the card fields without shipping an HTML parser or a headless browser into its runtime.

负责生成链接预览的发布、聊天或书签Agent无需在其运行时内置HTML解析器或无头浏览器，即可获取卡片所需字段。

Calling it

调用方式

A skill is loaded on its own, so this document has to be enough by itself. It does not assume the general

fittings

skill is also loaded.

call.mjs

ships alongside this file; if it is missing (this document reached you without the rest of the skill), fetch it once with

curl -sO https://fittings.sh/skill/call.mjs

Free, and needs no wallet. Read the schema and see what a call would cost:

bash

curl -s https://fittings.sh/catalog/doc.url-metadata | jq

Paying. The endpoint answers

402 Payment Required

with a signed quote, you sign an authorization, and a facilitator settles it — you never send a transaction and never pay gas. Before it spends anything, the client checks its own hash against the gateway and refuses rather than sign with logic the gateway has moved past:

bash

undefined

Skill是独立加载的，因此本文档本身需包含全部必要信息，无需假设已加载通用的

fittings

Skill。

call.mjs

与本文档一同提供；如果缺失（即您仅收到本文档而未获取完整Skill），可通过

curl -sO https://fittings.sh/skill/call.mjs

获取一次。

免费，无需钱包。查看Schema并了解调用成本：

bash

curl -s https://fittings.sh/catalog/doc.url-metadata | jq

付费调用：该接口会返回

402 Payment Required

响应及签名报价，您需签署授权，由服务商完成结算——您无需发送交易，也无需支付Gas费。在产生任何费用前，客户端会将自身哈希与网关进行校验，若网关逻辑已更新则拒绝签署：

bash

undefined

Dry run. Prints the quote and pays nothing, because no key is set.

试运行。仅打印报价，无需支付，因为未设置密钥。

node call.mjs doc.url-metadata url=https://example.com/

For real: a wallet holding USDC on Base, and nothing else.

实际调用：需持有Base网络上的USDC的钱包，无需其他资产。

export FITTINGS_PRIVATE_KEY=0x... node call.mjs doc.url-metadata url=https://example.com/


Spending is never a side effect of curiosity: with no `FITTINGS_PRIVATE_KEY`
the client fetches the quote and stops. `FITTINGS_MAX_PRICE` caps what it will
pay without asking, and defaults to $0.05.

**Use a throwaway wallet holding a few dollars, not a main one.** The key sits
in plaintext wherever the agent runs, and the whole cost of entry is USDC on
Base — no account, no API key, and no ETH, because the payer signs off-chain and
the facilitator broadcasts and pays the gas.

Writing your own client instead of using this one? `@x402/core` and
`@x402/evm` on npm, and the `fittings` skill records the two things that cost
real debugging time: the challenge is in a response header rather than the body,
and it must be re-signed from the exact request being retried.

If this is not the right service, `https://fittings.sh/catalog/search?q=...`
searches all of them for free.

export FITTINGS_PRIVATE_KEY=0x... node call.mjs doc.url-metadata url=https://example.com/


探索性操作不会产生费用：未设置`FITTINGS_PRIVATE_KEY`时，客户端仅获取报价即停止。`FITTINGS_MAX_PRICE`用于设置无需确认即可支付的最高金额，默认值为0.05美元。

**请使用仅持有少量资金的临时钱包，而非主钱包**。密钥以明文形式存储在Agent运行的环境中，入门仅需Base网络上的USDC——无需账户、API密钥或ETH，因为付款方进行链下签名，由服务商广播交易并支付Gas费。

不想使用该客户端，希望自行编写？可使用npm上的`@x402/core`和`@x402/evm`，`fittings` Skill记录了两个耗时调试的要点：挑战信息位于响应头而非响应体中，且必须针对重试的精确请求重新签名。

如果该服务不符合您的需求，可通过`https://fittings.sh/catalog/search?q=...`免费搜索所有可用服务。