SDK 与集成

适用于 serp.cheap API 的官方、零依赖或极少依赖的客户端。每一个都以类型化的参数和响应封装 POST /v1/search（以及 /v1/scrape 和 /v1/rank），在临时性错误时自动重试，并提供分页助手。 九种语言、面向主流 Web 技术栈的框架集成、一个 CLI，以及一个面向 AI 智能体的 MCP 服务器。

安装语言 SDK

JavaScript

npm install @serpcheap/sdk

Python

pip install serpcheap

Go

go get github.com/serpcheap/serpcheap-go

Rust

cargo add serpcheap

Java

<dependency>
  <groupId>cheap.serp</groupId>
  <artifactId>serpcheap</artifactId>
  <version>0.2.0</version>
</dependency>

PHP

composer require serpcheap/serpcheap

Ruby

gem install serpcheap

.NET

dotnet add package SerpCheap

Elixir

mix.exs

{:serpcheap, "~> 0.2"}

框架集成

即插即用的模块，将 SDK 接入你所用框架的配置、DI 容器和约定。

框架	语言	安装
Laravel	PHP	composer require serpcheap/laravel
Rails	Ruby	gem install serpcheap-rails
Django	Python	pip install serpcheap-django
FastAPI	Python	pip install serpcheap-fastapi
Spring Boot	Java	cheap.serp:serpcheap-spring-boot-starter (Maven)
NestJS	Node	npm install @serpcheap/nestjs
Next.js	Node	npm install @serpcheap/next
ASP.NET Core	.NET	dotnet add package SerpCheap.AspNetCore

命令行

go install github.com/serpcheap/serpcheap-cli@latest
# 然后
export SERPCHEAP_API_KEY=your_key
serpcheap search "best running shoes" --gl us

语言指南

JavaScript / TypeScript @serpcheap/sdk —— Node 18+，零依赖。

Python serpcheap —— Python 3.8+，仅标准库。

Go serpcheap-go —— Go 1.21+，仅标准库。

Rust serpcheap crate —— rustls，阻塞式客户端。

Java cheap.serp:serpcheap —— Java 11+。

所有客户端和集成都接受相同的搜索参数并返回相同的 响应结构。需要智能体/LLM 访问？参见 MCP 服务器。