@ fetcher-sh/ api (英语)

开发者友好客户端 获取器.sh —— 说 111个网上数据终端点 横跨Twitter/X,YouTube,TikTok,Instagram,Reddit,Google搜索,Google地图,Google新闻,Google Play,App Store,和Yelp. 将其作为国家预防机制 图书馆 或一个 国 际。 。 。 .

每个终点都是平地 GET 返回一个稳定 { status, message, data } 信封上写着 以美元支付 x402 (韩语),或将所有11项服务中的单项预付余额——相同 bby_live_ 关键在任何地方都有作用.

先决条件

• 节点.js 18+ (使用内置) fetch) (中文(简体) ).
• 其中一个:
  • 预付 API 密钥 (单位:千美元)bby_live_...)——得到一个在 获取器.sh/上架,或
  • A 类 钱包 在Base、Polygon、Arbitrum、Monad或Solana上持有几分USDC,以支付每笔拨打的x402(不需要钥匙).

安装

npm install @fetcher-sh/api

快速启动( 图书馆)

// ESM
import { Fetcher } from "@fetcher-sh/api";

// CommonJS
const { Fetcher } = require("@fetcher-sh/api");

const fetcher = new Fetcher({ apiKey: process.env.FETCHER_API_KEY });

// Search tweets
const tweets = await fetcher.twitter.search({ query: "x402" });

// Look up an Instagram profile by handle
const profile = await fetcher.instagram.userByHandle("nasa");

// Clean Google web-search results
const serp = await fetcher.google.search({ query: "climate change" });

console.log(tweets, profile, serp);

默认情况下,每种方法只返回 data 字段。 过 { fullResponse: true } 来得到整个 { status, message, data } 信封上写着.

const env = await fetcher.reddit.searchPosts(
  { query: "bitcoin" },
  { fullResponse: true },
);
console.log(env.status, env.message, env.data);

如果 apiKey 被省略,它会回到 FETCHER_API_KEY 环境变量.

服务和方法

一个余额,11个服务。 每个命名空间地图1:1到 实时目录。 。 。 .

普通出逃舱门

任何终点——即使没有指定助手的终点——都可以达到 get数字 :

await fetcher.get("/api/twitter/search", { params: { query: "x402" } });
await fetcher.get("/api/reddit/subreddit/programming/posts");

倾斜

贴出端点返回不透明 cursor。将它传回获取下一页:

let cursor: string | undefined;
do {
  const page = await fetcher.twitter.userFollowers("44196397", {
    fullResponse: true,
    params: { cursor },
  });
  // ...process page.data...
  cursor = (page.data as any)?.cursor;
} while (cursor);

用x402(无密钥)支付每个呼叫

跳过 API 密钥, 并通过一个 付款包 fetch 换句话说 客户端保持无依赖性——你带钱包:

import { Fetcher } from "@fetcher-sh/api";
import { wrapFetchWithPaymentFromConfig } from "@x402/fetch";
import { ExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount(process.env.PRIVATE_KEY as `0x${string}`);
const fetchWithPayment = wrapFetchWithPaymentFromConfig(fetch, {
  schemes: ["eip155:8453", "eip155:137", "eip155:42161", "eip155:143"].map(
    (network) => ({ network, client: new ExactEvmScheme(account) }),
  ),
});

const fetcher = new Fetcher({ fetch: fetchWithPayment });
const tweets = await fetcher.twitter.search({ query: "x402" }); // 402 → sign → retry, automatically

气体是赞助的,因此钱包不需要本地的代币——只要USDC在任何被支持的链上.

贷项

// Read the shared balance (needs an API key)
const balance = await fetcher.credits.balance();
console.log(balance.balance_usd);

// Top up (x402-paid; requires a payment-wrapped fetch). The first top-up
// returns the bby_live_ key EXACTLY ONCE — store it, it cannot be recovered.
const result = await fetcher.credits.topup(5);
console.log(result.key);

处理错误

每个非-2xx响应都会发出一个 FetcherError 带有状态、解析后的信封和助手:

import { FetcherError } from "@fetcher-sh/api";

try {
  await fetcher.twitter.search({ query: "x402" });
} catch (err) {
  if (err instanceof FetcherError) {
    if (err.isTopupRequired) console.error("Out of credits — top up.");
    else if (err.isUnauthorized) console.error("Bad or rotated API key.");
    else if (err.isPaymentRequired) console.error("x402 payment required.");
    else console.error(err.status, err.message);
  }
}

国 际

从命令行安装到全球使用 :

npm install -g @fetcher-sh/api

设置

# Store your API key (saved to ~/.fetcher-sh/config.json)
fetcher init --token bby_live_xxx

# Or set it as an environment variable
export FETCHER_API_KEY=bby_live_xxx

# Or pass it per command
fetcher balance --token bby_live_xxx

图标

# Shortcuts for each service's hero endpoint
fetcher twitter-search "x402"
fetcher youtube-search "lofi hip hop"
fetcher tiktok-search "cats"
fetcher instagram-user nasa
fetcher reddit-search "bitcoin"
fetcher google-search "climate change"
fetcher google-maps-search "coffee near me"
fetcher google-news-search "artificial intelligence"
fetcher googleplay-apps "notes"
fetcher appstore-apps "notes"
fetcher yelp-search "coffee" --location "San Francisco"

# Call ANY endpoint by path; extra --flags become query params
fetcher get /api/twitter/user/44196397/tweets --cursor abc123
fetcher get /api/reddit/subreddit/programming/posts

# Credits
fetcher balance
fetcher topup --amount 5          # needs an x402 wallet — see notes

# Explore the catalog
fetcher services
fetcher endpoints twitter

输出选项

fetcher twitter-search "x402"              # pretty JSON (default)
fetcher twitter-search "x402" --json       # compact JSON
fetcher twitter-search "x402" --jsonl      # one object per line (arrays)
fetcher twitter-search "x402" --output out.json
fetcher get /api/x/y --debug               # show raw error bodies

全球旗帜

API 参考

new Fetcher(options?)

请求选项( 每一次呼叫)

静态

• Fetcher.endpoints() ——111个出价终点的完整目录.
• Fetcher.services() ——每个服务元数据(主机,计数,汇总).
• Fetcher.priceOf(path) ——路径(支持的路径)的美元价格.

页:1

• 设计时只读. 每个终点都是 GET ——没有写作,后面写作,也没有文章.
• 无利率限制. 您的平衡( 或钱包) 是自然回压 .
• 上游故障时不退. 在交货前解决.
• 这个 非正式 fearer.sh的客户端,它本身是一个独立的代理,与X,TikTok,Meta,Google,Yelp或Apple没有隶属关系.

许可证

麻省理工学院