五步接入：从零到第一条 200

# 第 1 步：填申请表（浏览器打开，纯 HTML 表单，不用 JS）
https://search.ozforce.cn/apply

# 或者用程序提交同一张表（返回 application_id，状态 pending）
curl -sS -X POST "https://search.ozforce.cn/v1/apply" \
  -H "Content-Type: application/json" \
  -d '{"name":"李四","email":"lisi@example.com","purpose":"给公司内部 AI 助手做联网检索，每天几百次","expected_daily_calls":200}'

# 第 3 步：审批通过后打开领取链接（明文只显示这一次，看到就存进密码管理器）
https://search.ozforce.cn/claim/<领取码>

# Windows PowerShell：只对这个窗口有效（永久生效请用 [Environment]::SetEnvironmentVariable）
$env:WS_API_KEY = '<你的 key>'

# macOS / Linux：只对这个终端有效（永久生效请写进 ~/.bashrc 或 ~/.zshrc）
export WS_API_KEY='<你的 key>'

# 第一个请求：结果档 l1 —— 拿回来源列表 + 一条永久快照链接
curl -sS -X POST "https://search.ozforce.cn/v1/search" \
  -H "Authorization: Bearer ${WS_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"q":"杭州 三日游 攻略","count":5,"freshness":"month","snapshot":true}'

rem Windows 命令行（cmd.exe）：在同一窗口先 set WS_API_KEY=你的key，再粘贴下一行
curl -sS -X POST "https://search.ozforce.cn/v1/search" -H "Authorization: Bearer %WS_API_KEY%" -H "Content-Type: application/json" -d "{\"q\":\"杭州 三日游 攻略\",\"count\":5,\"freshness\":\"month\",\"snapshot\":true}"

// 存成 first.mjs，然后：node first.mjs（Node 18+ 自带 fetch，不用装任何包）
const BASE = 'https://search.ozforce.cn'
const KEY = process.env.WS_API_KEY
if (!KEY) {
  console.error('先设置环境变量 WS_API_KEY（值是你的 API key）')
  process.exit(1)
}

const res = await fetch(BASE + '/v1/search', {
  method: 'POST',
  headers: { Authorization: 'Bearer ' + KEY, 'Content-Type': 'application/json' },
  body: JSON.stringify({ q: '杭州 三日游 攻略', count: 5, freshness: 'month', snapshot: true })
})

const data = await res.json()
if (!res.ok) {
  console.error('失败', res.status, data.error)
  process.exit(1)
}

console.log('扣费', data.usage.credits_charged, 'credits，余额', data.usage.balance_after)
console.log('永久链接', data.snapshot_url)
for (const s of data.sources) console.log('-', s.title, s.url)

# Python 3.8+，只用标准库
import json, os, urllib.request

BASE = 'https://search.ozforce.cn'
KEY = os.environ.get('WS_API_KEY')
if not KEY:
    raise SystemExit('先设置环境变量 WS_API_KEY（值是你的 API key）')

body = json.dumps({'q': '杭州 三日游 攻略', 'count': 5, 'freshness': 'month', 'snapshot': True}).encode('utf-8')
req = urllib.request.Request(
    BASE + '/v1/search', data=body, method='POST',
    headers={'Authorization': 'Bearer ' + KEY, 'Content-Type': 'application/json'},
)
with urllib.request.urlopen(req) as res:
    data = json.loads(res.read().decode('utf-8'))

print('扣费', data['usage']['credits_charged'], 'credits，余额', data['usage']['balance_after'])
print('永久链接', data['snapshot_url'])
for s in data['sources']:
    print('-', s['title'], s['url'])

# Windows PowerShell 5.1 / PowerShell 7 都能直接跑（先设好 $env:WS_API_KEY）
$Base = 'https://search.ozforce.cn'
$Key  = $env:WS_API_KEY
if (-not $Key) { throw '先设置环境变量 WS_API_KEY：$env:WS_API_KEY = ''<你的 key>''' }

# 中文 body 必须发 UTF-8 字节：PowerShell 5.1 直接把字符串交给 -Body，中文会按本地代码页变成问号
$Json  = @{ q = '杭州 三日游 攻略'; count = 5; freshness = 'month'; snapshot = $true } | ConvertTo-Json -Compress
$Bytes = [System.Text.Encoding]::UTF8.GetBytes($Json)

$R = Invoke-RestMethod -Method Post -Uri "$Base/v1/search" `
  -Headers @{ Authorization = "Bearer $Key" } `
  -ContentType 'application/json; charset=utf-8' `
  -Body $Bytes

"扣费 $($R.usage.credits_charged) credits，余额 $($R.usage.balance_after)"
"永久链接 $($R.snapshot_url)"
$R.sources | Select-Object title, url | Format-Table -AutoSize

# 读 HTML 页面（例如 /products、/v1/catalog）时务必加 -UseBasicParsing：
#   Invoke-WebRequest "$Base/products" -UseBasicParsing | Select-Object -Expand Content

# 把上一步响应里的 snapshot_url 原样打开（不需要 key）：
#   https://search.ozforce.cn/s/<token>        人读的 HTML 页（离线保存也能读）
#   https://search.ozforce.cn/s/<token>.json   同一份内容的原始数据
curl -sS "https://search.ozforce.cn/s/<token>.json"

# 二级单元：m1/news（结果结构更贴合该领域，价格见页面上的单元卡片）
curl -sS -X POST "https://search.ozforce.cn/v2/m1/news/run" \
  -H "Authorization: Bearer ${WS_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"q":"科技","count":5,"snapshot":true}'

// 二级单元 m1/news：返回 items[]（结构按单元的 resultSchema）
const BASE = 'https://search.ozforce.cn'
const KEY = process.env.WS_API_KEY
if (!KEY) { console.error('先设置环境变量 WS_API_KEY'); process.exit(1) }

const res = await fetch(BASE + '/v2/m1/news/run', {
  method: 'POST',
  headers: { Authorization: 'Bearer ' + KEY, 'Content-Type': 'application/json' },
  body: JSON.stringify({ q: '科技', count: 5, snapshot: true })
})
const data = await res.json()
if (!res.ok) { console.error('失败', res.status, data.error); process.exit(1) }

console.log('共', data.items.length, '条，扣费', data.usage.credits_charged, 'credits')
console.log('永久链接', data.snapshot_url)
for (const item of data.items) console.log('-', item.title, item.url)

# 二级单元 m1/news
import json, os, urllib.request

BASE = 'https://search.ozforce.cn'
KEY = os.environ.get('WS_API_KEY')
if not KEY:
    raise SystemExit('先设置环境变量 WS_API_KEY')

body = json.dumps({'q': '科技', 'count': 5, 'snapshot': True}).encode('utf-8')
req = urllib.request.Request(
    BASE + '/v2/m1/news/run', data=body, method='POST',
    headers={'Authorization': 'Bearer ' + KEY, 'Content-Type': 'application/json'},
)
with urllib.request.urlopen(req) as res:
    data = json.loads(res.read().decode('utf-8'))

print('共', len(data['items']), '条，扣费', data['usage']['credits_charged'], 'credits')
print('永久链接', data['snapshot_url'])

# 单元目录（公开，不要 key）
curl -sS "https://search.ozforce.cn/v1/units"