@anakin-io/ sdk (英语)
正式节点.js / 类型脚本 SDK 阿纳金 ——网络刮取,爬行,搜索,和有线动作.
状态:α (v0.1.x). 公共API在小版本之间可以更改到v1.0.
安装
npm install @anakin-io/sdk
# or
pnpm add @anakin-io/sdk
# or
yarn add @anakin-io/sdk
快速启动
import { Anakin } from '@anakin-io/sdk'
const client = new Anakin({ apiKey: 'ak-...' }) // or set ANAKIN_API_KEY env var
// Scrape a single URL
const doc = await client.scrape('https://example.com', { formats: ['markdown'] })
console.log(doc.markdown)
// Discover URLs on a site
const sitemap = await client.map('https://example.com', { limit: 200 })
console.log(sitemap.links)
// Crawl pages and get content
const crawl = await client.crawl('https://example.com', { maxPages: 20 })
for (const page of crawl.pages) {
console.log(page.url, page.markdown?.length ?? 0)
}
SDK的民调在内部长期工作 await. 没有工作证可管理.
配置
const client = new Anakin({
apiKey: 'ak-...', // or ANAKIN_API_KEY env var
timeoutMs: 60_000, // per-request HTTP timeout
maxRetries: 4, // retries on 429/5xx
pollIntervalMs: 1_000, // initial polling delay
pollMaxIntervalMs: 10_000, // max polling delay
pollTimeoutMs: 300_000, // total wait before JobTimeoutError
})
错误
import {
AnakinError, // base for everything below
AuthenticationError, // bad/missing API key
InsufficientCreditsError, // 402 (exposes .balance, .required)
InvalidRequestError, // 400
JobFailedError, // job came back with status="failed"
JobTimeoutError, // pollTimeoutMs exceeded
RateLimitError, // 429 (exposes .retryAfter)
ServerError, // 5xx after retries
NetworkError, // DNS/connection/timeout
WireAuthRequiredError, // wire action needs account connection (.connectUrl)
} from '@anakin-io/sdk'
方法
| 方法 | 回返 |
|---|---|
client.scrape(url, opts) | Promise<Document> |
client.map(url, opts) | Promise<MapResult> |
client.crawl(url, opts) | Promise<CrawlResult> |
client.search(prompt, opts) | Promise<SearchResult> (同步 API) |
client.agenticSearch(prompt, opts) | Promise<AgenticSearchResult> |
client.wire(actionId, params, opts) | Promise<WireResult> |
client.sessions.list(opts) | Promise<BrowserSession[]> |
client.sessions.create(opts) | Promise<BrowserSessionHandle> |
client.sessions.save(instanceId) | Promise<BrowserSession> |
client.sessions.update(id, { name }) | Promise<BrowserSession> |
client.sessions.delete(id) | Promise<void> |
client.countries() | Country[] (静态,没有网络呼叫) |
发展
npm install
npm run typecheck
npm run lint
npm run test
npm run build
许可证
阿帕奇2.0 (英语). 见 自由主义。 。 。 .