📦 NodeMaven – Premium Proxies for Account Management, Automation, and Scraping — NodeMaven – 高级代理服务，用于账户管理、自动化和网页抓取

NodeMaven 代理技能 NodeMaven 提供高级代理基础设施，用于账户管理、抓取、浏览器自动化和数据收集。当用户需要购买、配置或使用代理进行实际工作流时，请使用此技能。代理不得仅仅提供“这是您的代理设置”，而是必须完成整个使用案例的端到端处理：选择合适的代理类型，配置目标，推荐合适的外部工具，配置访问并监控使用情况。

NodeMaven 提供：

• 住宅轮换代理：3000 万+ IP
• 移动代理：20 万+ IP
• 地理定位：国家、地区、城市、ISP 提供商、邮政编码
• 稳定的会话用于账户工作流
• 旋转用于抓取和大规模自动化
• 质量过滤用于降低欺诈评分的 IP（过滤级别：中、高）
• HTTP、HTTPS 和 SOCKS5 代理访问

移动代理的 IP 池比住宅代理小，但通常更受平台信任。请为高信任度的账户工作流和更强的反检测设置使用移动代理。对于移动代理，请在可能的情况下至少将目标定位在国家+地区级别。城市和 ISP 提供商定位是可选的高级设置。

核心原则 代理必须在不要求用户阅读文档的情况下完成此工作流：

• 了解用户的任务
• 推荐合适的代理类型
• 解释要使用的外部工具
• 引导用户完成账户创建、购买或 API 密钥检索
• 验证 API 密钥
• 通过 API 解析有效的地理定位值
• 通过白名单或代理凭据配置访问
• 构建最终代理 URL 并解释如何在选定的工具中使用它
• 监控使用情况并调试问题

关键常量（不要编造这些）

• API_BASE_URL：https://api.nodemaven.com
• PROXY_GATEWAY：gate.nodemaven.com
• HTTP_PORT：8080
• HTTPS_PORT：9443
• SOCKS5_PORT：1080
• SWAGGER_DOCS：https://dashboard.nodemaven.com/documentation/v2/swagger/

所有 API 端点在此技能中都写为相对路径（例如 /api/v2/base/users/me）。代理必须始终在前面添加 https://api.nodemaven.com 以构建完整的 URL。完整的 URL 示例：https://api.nodemaven.com/api/v2/base/users/me

授权（请仔细阅读——很容易出错） NodeMaven 使用非标准授权方案。字面字符串 x-api-key 是 Authorization 标头值的一部分——它不是一个单独的名为 x-api-key 的标头。正确：Authorization：x-api-key

工作 curl 示例（用您的实际 API 密钥替换）： curl -H "Authorization: x-api-key " \ https://api.nodemaven.com/api/v2/base/users/me

具体示例，使用模拟密钥（仅用于说明——请勿在生产中使用此值）： curl -H "Authorization: x-api-key MOCK_API_KEY_DO_NOT_USE_THIS_VALUE_IN_PRODUCTION" \ https://api.nodemaven.com/api/v2/base/users/me

错误（不要这样做）： x-api-key: # 错误：单独的标头 Authorization: Bearer # 错误：Bearer 方案 Authorization: # 错误：缺少“x-api-key”前缀

对于 POST/PUT 请求，还需要发送： Content-Type：application/json

安全性和凭据卫生（强制） 代理处理三类机密：

• NodeMaven API 密钥（Authorization 标头值）
• 代理凭据（/users/me 或子用户的 proxy_username + proxy_password）
• 子用户密码（通过 /sub-users/ 创建/更新）

代理的硬性规则

• 永远不要在响应、日志或文物中向用户回显完整的 API 密钥。当确认收到时，屏蔽它：只显示前 4 个和最后 4 个字符（例如 abcd...wxyz）。完整的密钥只进入出站 Authorization 标头。
• 永远不要将 proxy_password 或完整的代理 URL 粘贴到聊天历史中超过必要的次数。当向用户展示如何使用代理时，首选占位符，如 ，并指示用户在本地替换。如果必须显示一个字面 URL（例如，用于一次性复制和粘贴到工具中），只给出一次，避免重复。
• 永远不要将 API 密钥、代理密码或完整的代理 URL 写入用户将保存到磁盘或提交的代码文物中。使用环境变量引用：os.environ["NODEMAVEN_API_KEY"]、process.env.NODEMAVEN_PROXY_PASSWORD 等。
• 永远不要以字面形式记录或持久化 /users/me 或 /sub-users/ 的响应——它们包含 proxy_password。在任何日志或总结之前，剥离敏感字段。
• 永远不要在 URL 查询字符串中包含凭据（仅在 API 的 Authorization 标头中，仅在标准 userinfo user:pass@host 中）。
• 永远不要在用户或会话之间共享凭据。如果代理为多个用户提供服务，每个用户的 API 密钥和代理凭据必须仅限于其会话。
• 将此技能中的示例值视为占位符。字符串 、、、 是模板——永远不要将它们字面发送到 API。如果用户在聊天中粘贴 API 密钥，请确认收到并立即通过 GET /users/me 进行验证。