osint-services/phone_search
GitHub: osint-services/phone_search
一个使用 Twilio Lookup v2 查询电话号码来电者姓名及元数据的 FastAPI 微服务。
Stars: 1 | Forks: 0
# phone_search
一个小型 FastAPI 微服务，使用 Twilio Lookup v2 解析电话号码的来电者姓名信息。
## 概述
本服务暴露了一个单独的 endpoint，用于查询 E.164 格式电话号码的来电者姓名元数据。
## 环境要求
- Python 3.9 或更高版本
- 拥有 Lookup API 访问权限的 Twilio 账户
## 环境变量
- `TWILIO_ACCOUNT_SID`
- `TWILIO_AUTH_TOKEN`
如果缺少任何一个环境变量，服务将无法启动。
## 技术栈
- FastAPI
- Uvicorn
- Twilio Python SDK
- Pydantic
## 设置说明
1. 创建 Python 虚拟环境：
`python -m venv venv`
2. 激活虚拟环境：
`source venv/bin/activate`
3. 安装依赖项：
`pip install -r requirements.txt`
4. 设置你的 Twilio 凭证：
`export TWILIO_ACCOUNT_SID=your_sid`
`export TWILIO_AUTH_TOKEN=your_token`
5. 启动服务器：
`uvicorn server:app --reload`
## Endpoint
- GET `/lookup/caller-name?phone_number={phone_number}`
- 查询参数：`phone_number`，需为 E.164 格式，例如 `+18135551212`
- 返回所请求电话号码的来电者姓名元数据。
## 响应示例
```
{
"phone_number": "+18135551212",
"valid": true,
"national_format": "+1 813-555-1212",
"country_code": "US",
"caller_name": "SCAM ALERT",
"caller_type": "business",
"error": null
}
```
## 注意事项
- 当前实现使用 `twilio.rest.Client` 和 Twilio Lookup v2。
- 来自 Twilio 的错误将作为 HTTP 错误返回，并包含 JSON detail payload。
标签：AV绕过, FastAPI, GitHub, Twilio, 实时处理, 电话查询, 身份解析, 逆向工具