Back to Details

fittings-doc-url-to-markdown

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

URL to clean Markdown

URL 转纯净 Markdown

doc.url-to-markdown
on 
https://fittings.sh
. One endpoint, web and network.
Fetch a public web page and return it as clean Markdown with its title. Capped at 2 MB.
doc.url-to-markdown
部署于 
https://fittings.sh
，是一个面向网页与网络的单一接口。
获取公开网页并将其转换为带标题的干净Markdown格式，内容上限为2MB。

The call

调用方式

GET https://fittings.sh/v1/doc/url-to-markdown
FieldTypeRequiredNotes
url
stringyesPublic http(s) URL
Example input:
json
{
  "url": "https://example.com/"
}
GET https://fittings.sh/v1/doc/url-to-markdown
字段类型是否必填说明
url
string是公开的http(s) URL
示例输入：
json
{
  "url": "https://example.com/"
}

Metered

按使用量计费

The 402 quotes a ceiling — the price of the declared cap, 2000000 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响应会给出一个上限价格——即声明的2000000字节容量对应的费用——而最终结算按实际调用使用的字节数计算。小请求的结算费用会低于报价，因此报价应视为上限而非固定价格。

Cost and provenance

费用与来源

Price$0.003 per call, metered per bytes
Sourcelive fetch of the caller-supplied URL
Licencepermissive
AttributionContent belongs to the origin publisher
项目说明
价格每次调用0.003美元，按字节数计费
来源实时获取调用者提供的URL内容
许可证宽松许可
归属内容归原发布者所有

Why call it rather than answer from memory

为何调用该服务而非从内存获取

This is the third-highest-demand category observed on-chain: an agent given a link needs the readable text, not the markup, and cannot run a browser itself.
这是链上需求第三高的服务类别：Agent拿到链接后需要可读文本而非标记语言，且自身无法运行浏览器。

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-to-markdown | 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-to-markdown | 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-to-markdown url=https://example.com/
node call.mjs doc.url-to-markdown 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-to-markdown 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-to-markdown 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=...`免费搜索所有服务。