关于 Offendersearch
Offendersearch 是用于查询美国性犯罪者登记信息和刑事记录的 REST API，面向身份筛查场景。它汇总 58 个州、特区及属地登记库，并为匹配结果提供置信度评分和来源引用。
主要功能
- 01一次查询覆盖 58 个登记库
- 02按姓名、生日或年龄筛查
- 03按邮编和半径搜索
- 04批量筛查记录
- 05匹配结果附来源和官方链接
适用场景
- 01核查个人是否出现在公开登记记录中
- 02按地区查找附近的登记记录
- 03一次筛查整份人员名单
配置
远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。
服务地址
https://mcp.offendersearch.app/mcp一键复制安装命令
Claude CodeTerminal
claude mcp add --transport http app-offendersearch-offendersearch https://mcp.offendersearch.app/mcpCursor.cursor/mcp.json
{"mcpServers":{"app-offendersearch-offendersearch":{"type":"http","url":"https://mcp.offendersearch.app/mcp"}}}在 Cursor 中打开VS Code.vscode/mcp.json
{"servers":{"app-offendersearch-offendersearch":{"type":"http","url":"https://mcp.offendersearch.app/mcp"}}}在 VS Code 中打开Claude Desktopclaude_desktop_config.json
{"mcpServers":{"app-offendersearch-offendersearch":{"type":"http","url":"https://mcp.offendersearch.app/mcp"}}}Windsurf~/.codeium/windsurf/mcp_config.json
{"mcpServers":{"app-offendersearch-offendersearch":{"serverUrl":"https://mcp.offendersearch.app/mcp"}}}命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
5| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| q | any | 否 | 在姓名／别名／地址／城市／州／邮编中进行自由文本搜索（所有词元都必须出现）。 |
| age | any | 否 | 年龄筛选器，DOB 未知时使用。为应对生日日期偏差，匹配范围为 ±1 年。 |
| dob | any | 否 | 出生日期 'YYYY-MM-DD'。可提高匹配精度；用于判定 dobVerification（dob_match / year_match）。 |
| lat | any | 否 | GIS 半径検索的纬度（与 lng 配对使用）。 |
| lng | any | 否 | GIS 半径検索的经度（与 lat 配对使用）。 |
| city | any | 否 | 居住城市筛选器。 |
| match | enum | 否 | 模糊匹配容差：strict=精确匹配；balanced=名字支持昵称、变体、首字母和拼写错误，姓氏精确匹配；broad=姓氏也支持前缀和拼写错误。strict | balanced | broad |
| state | any | 否 | 2 个字母的州／领地代码（例如 'IL'、'PR'），或完整名称。这是居住地筛选条件，不会更改运行哪些登记库；仍会搜索全部 58 个登记库。筛选采用并集：记录在该州有地址，或由该州的登记库持有，即会保留。每条记录都包含 `registrationState` 和 `addressStates`，以便判断符合的是哪一部分；若只筛选登记库部分，请传入 `jurisdictions`。 |
| address | any | 否 | 模糊街道地址筛选条件（每个词元都必须出现在某条记录的某个地址中）。 |
| zipcode | any | 否 | 居住地 ZIP 邮政编码（使用前 5 位数字）。 |
| extensive | boolean | 否 | 若为 true，则请求详细信息（保留 offenses[]、stateData、images）。简略调用会省略这些内容。 |
| freshness | enum | 否 | 缓存／定价层级：daily=≤24 小时（默认），weekly=≤7 天。daily | weekly |
| last_name | any | 否 | 姓氏——主要匹配键，例如 'Smith'。 |
| first_name | any | 否 | 名字，例如 'John'。 |
| deadline_ms | integer | 否 | 最长等待时间，单位为毫秒（默认 120000／2 分钟）。调低可更快获得有时限的响应；部分结果会返回 status='partial'。 |
| radius_miles | any | 否 | 以英里为单位、以 lat/lng 为中心的 GIS 半径。指定点时默认为 1；上限为 100。 |
| jurisdictions | any | 否 | 要查询的登记库代码（例如 ['IL','TX']）。省略/设为 null = 全部 58 个登记库。代码请参阅 get_registry_coverage。 |
| location_scoped | boolean | 否 | 仅限主动选择，且绝不根据 `state` 推断。如果为 true 且设置了州，则仅查询覆盖该州的登记库，而不是全部 58 个。这是一个会牺牲召回率的成本选项：居住在请求州、但在其他州登记库登记的人员将被排除（占记录的 7.0%）。适用时，响应会报告 counts.sourcesSkippedByScope，并显示 NARROWED SEARCH 警告。除非调用方明确希望进行成本更低、范围更窄的搜索，否则请保持为 false。 |
详细介绍
Offendersearch — API 快速入门
通过一次 REST 调用，即可筛查美国全部 58 个性犯罪者登记库——涵盖每个州、DC 和各个领地。
- 🌐 网站：https://offendersearch.app
- 📖 文档：https://offendersearch.app/docs
- 🧾 OpenAPI 规范：https://offendersearch.app/openapi.json
- 🔗 基础 URL：
https://api.offendersearch.app
在 offendersearch.app 获取密钥——免费试用包含 25 次搜索，无需信用卡。然后进行设置：
export OFFENDERSEARCH_KEY="sk_your_key"
一次调用，查询 58 个登记库
curl https://api.offendersearch.app/v1/search \
-H "Authorization: Bearer $OFFENDERSEARCH_KEY" \
-H "Content-Type: application/json" \
-d '{ "query": { "firstName": "John", "lastName": "Smith", "dob": "1982-04-11" } }'
每条匹配结果都会标注置信度评分并注明来源，同时提供照片和官方登记记录链接。提供出生日期或年龄可以提高匹配精度。
搜索某个区域（无需姓名）
curl https://api.offendersearch.app/v1/search \
-H "Authorization: Bearer $OFFENDERSEARCH_KEY" \
-H "Content-Type: application/json" \
-d '{ "query": { "zipcode": "92501", "radiusMiles": 2 } }'
筛查整份名单
POST /v1/batch 可通过一次调用检查多条记录——请参阅文档。
本仓库中的示例
| 语言 | 文件 |
|---|---|
Node.js（零依赖，fetch） | node/search.mjs |
Python（requests） | python/search.py |
| curl | curl/search.sh |
根据 OpenAPI 规范，可为任何语言生成类型化客户端。
负责任地使用
结果是公开记录数据，并非消费者报告。未经法律要求的流程，不要将其用于就业、租赁或其他受 FCRA 约束的决策；也绝不可用来识别、针对或骚扰任何人。请仅用于提高认知和保障安全。
许可证
MIT
评论
支持 Markdown
一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。