核心用法
Bluepages 是一个专注于 Web3 身份解析的查询工具，核心功能是将以太坊钱包地址与 Twitter/X、Farcaster 社交账号进行双向映射查询。用户可通过 MCP 服务器或直连 HTTP API 使用，支持单条查询和批量查询两种模式。
单条查询推荐采用"先检查后获取"的两阶段策略：先用 check_address 或 check_twitter（1 积分）确认目标是否存在数据，命中后再调用 get_data_for_address 或 get_data_for_twitter（50 积分）获取完整信息。批量查询（最多 50 条）同样遵循此逻辑，通过 batch_check + batch_get_data 组合可节省约 90% 费用。对于超大规模列表（100+），提供 _streaming 变体以实时展示进度。
认证方式灵活：持有 BLUEPAGES_API_KEY 可享受 20% 折扣和双倍速率限制（60 req/min）；无 API Key 时可通过 PRIVATE_KEY 使用 x402 协议按请求付费（30 req/min），或直接在官网购买积分。
显著优点
1. 数据规模与质量：覆盖 80 万+经过验证的地址-社交账号映射，数据源可靠性高
2. 成本透明可控：按请求计费，未命中不收费，配合两阶段查询策略可大幅优化成本
3. 灵活的支付体系：既支持传统 API Key 预付费，也支持 x402 区块链原生支付
4. 完善的批量能力：原生支持 50 条批量查询，streaming 模式适配大规模数据处理
5. 明确的输入规范：地址格式（0x 前缀、42 字符十六进制）和 Twitter 句柄格式均有清晰定义，降低使用门槛
潜在缺点与局限性
1. 外部依赖性强：必须依赖 Bluepages MCP 服务器或外部 API，无法离线使用
2. 私钥管理风险：x402 支付方案需要配置以太坊私钥，虽文档明确警示，但仍存在用户误用主钱包的安全隐患
3. 速率限制较严格：即使使用 API Key，60 req/min 的限速对高频场景可能不足
4. 成本累积效应：单条完整查询 0.05 美元，大规模批量查询成本可达数十美元，需精细规划
5. 数据覆盖边界：仅覆盖已验证的映射关系，新兴地址或隐私保护良好的用户可能无记录
适合的目标群体
- Web3 安全分析师：进行地址溯源、钓鱼攻击调查、资金流向追踪
- 链上数据研究员：需要关联社交身份与链上行为的学术或商业研究
- 合规与风控团队：执行 KYC/AML 相关的地址背景调查
- 社交媒体运营：验证 KOL 或项目方声明的钱包地址真实性
- 开发者：构建需要身份解析功能的 DApp 或分析工具
使用风险
1. 私钥泄露风险：若用户忽视文档警告，将主钱包私钥配置为 PRIVATE_KEY，可能导致资金损失
2. 费用超支风险：未采用两阶段查询策略直接调用高成本接口，或批量查询未过滤空数据，造成不必要的积分消耗
3. API 可用性风险：服务依赖 Bluepages 官方基础设施，存在单点故障可能
4. 数据时效性风险：社交账号与地址的映射关系可能随时间变化，查询结果需结合其他信息交叉验证
5. MCP 服务器信任假设：需信任 bluepagesdoteth 官方仓库的 MCP 服务器实现无恶意代码