基于 i7 14700KF + 索引 三级缓存架构 | TB 级大数据毫秒级检索
支持无限关键词链式过滤，自动在后台建立行号索引，提供双节点接入方案满足不同地区访问需求。
| 参数名 | 必填 | 类型 | 说明 |
|---|---|---|---|
cx |
是 | String | 检索词，多个条件用逗号 , 分隔（如：姓名,学校,城市） |
key |
是 | String | 您的 Access Key |
page |
否 | Int | 页码（默认 1） |
limit |
否 | Int | 每页返回记录数（默认 10，最大 100） |
1. 单条件精准查询：
适合通过手机号、姓名或身份证号进行快速定位。
2. 多条件链式过滤（无限参数）：
使用英文逗号分隔多个词。系统会执行 AND 逻辑，同时包含这些词的结果才会被返回。
3. 带分页控制的查询：
通过 page 和 limit 调整返回范围，配合 total_pages 进行翻页逻辑开发。
接口通过 xg_msg 返回当前查询的性能来源：
| 状态码 | 类型 | 说明 | 响应速度 |
|---|---|---|---|
| xg_001 | 全盘扫描 | 索引 未命中，正在进行 428GB 文件检索。 | 1s - 5s |
| xg_002 | 数据缓存 | 一级缓存命中，直接读取解析后的 JSON 结果。 | < 20ms |
| xg_003 | 行号索引 | 二级缓存命中，通过记录的精准定位文件内容。 | 100ms - 300ms |
| xg_err | 报错 | 具体原因请看返回信息 | - |
| xg_000_A3 | 单条件索引 | 手机号/姓名索引命中，毫秒级精准检索 | < 50ms |
| xg_000_A3_MULTI | 多条件索引 | 多条件先索引后过滤，极速响应 | < 100ms |
{
"xg_msg": "xg_002", // 检索性能状态码
"total_count": 150, // 符合条件的总记录数
"current_page": 1, // 当前页码
"total_pages": 15, // 总页数
"remaining_pages": 14, // 剩余可翻页数
"user": "XG_test", // 授权用户
"expiry": "2099-12-31", // 到期时间
"query_time_ms": 18.5, // 查询耗时（毫秒）
"data": [
{
"name": "刘**",
"phone": "138****8888",
"school": "**市**小学",
"id_card": "120101********1234",
"email": "liu@example.com",
"id_num": "2024001"
}
]
}
import requests
def xg_pro_search():
# 双节点可选：亚太优化 / Cloudflare全球优化
api_url = "https://xgapi.xg66.top/api" # 亚太优化
# api_url = "https://api.xg66.top/api" # Cloudflare全球优化
api_key = "Your_Key"
cx = input("请输入搜索词(多条件逗号隔开，如:张三,北京): ").strip()
params = {
"cx": cx,
"key": api_key,
"page": 1,
"limit": 10
}
try:
resp = requests.get(api_url, params=params, timeout=15)
res = resp.json()
status_map = {
"xg_001": "⚡ 全盘扫描 (后台正在为您建立加速索引)",
"xg_002": "🚀 内存级缓存 (极速响应)",
"xg_003": "🎯 索引级定位 (精准检索)",
"xg_000_A3": "🔥 单条件索引 (毫秒级命中)",
"xg_000_A3_MULTI": "💥 多条件索引 (极速过滤)"
}
print(f"\n[状态] {status_map.get(res['xg_msg'], '未知状态')}")
print(f"[耗时] {res.get('query_time_ms', 0)} 毫秒")
print(f"[结果] 总命中: {res['total_count']} 条 | 共 {res['total_pages']} 页")
print("-" * 50)
for item in res.get("data", []):
print(f"姓名: {item['name']} | 手机: {item['phone']} | 学校: {item['school']}")
except Exception as e:
print(f"请求失败: {e}")
if __name__ == "__main__":
xg_pro_search()