Integration Center
接口中心：站点需要接入的 API 清单与测试
这里列出 SEO 流量工厂要真正跑起来必须接的 API，包括 AI、发布、收录、排名、竞品、外链和目标站接口。每个接口都显示用途、环境变量、当前状态和测试入口。
接口项
12
必接/可选/待接入
已配置
3
环境变量存在
待配置
9
需要补凭证
可运行
2
已接入或可查询
站点
15
多站点发布对象
发布通道
25
SitePublisherConfig
整体运行逻辑
基础设施接口
PostgreSQL 和 Redis 是系统运行底座，决定后台能不能保存数据、Worker 能不能跑队列。
AI生成接口
OPENAI_API_KEY 决定内容工厂是真 AI 生成，还是降级到模板内容。
目标站发布接口
10个站点要独立访问，就需要每个站点有 Remote API、Webhook、SFTP 或静态发布通道。
搜索引擎提交接口
百度、360、搜狗、必应/IndexNow 都需要站长平台凭证或提交 token；Google 走 Search Console。
排名查询接口
排名中心需要 SERP 数据源、Google Search Console 或自建采集服务，才能形成真实排名反馈。
竞品外链数据源
竞品关键词和外链属于独立采集源，需要后续接入专用采集器或第三方 API。
需要人工设置的 API
AI：OPENAI_API_KEY、OPENAI_MODEL
发布：PUBLISH_WEBHOOK_URL 或每站点 Remote API
收录：INDEXNOW_KEY、百度/360/搜狗站长 token
Google：Search Console服务账号
排名：SERPAPI_KEY 或 RANKING_API_URL
竞品：COMPETITOR_API_URL
外链：BACKLINK_API_URL
目标站：SITE_API_BASE_URLS、SITE_API_TOKEN
基础设施：DATABASE_URL、REDIS_URL
本页只显示接口是否配置，不显示密钥明文。真实调用会消耗外部 API 配额，默认先入队测试；勾选“允许真实外部API测试”后才直接请求外部接口。
配置与测试按钮
接口配置与测试控制台
当前选择：PostgreSQL 正式数据库；配置状态：已配置；运行状态：已接入。
等待操作
API 接口清单
| 接口 | 模块 | 用途 | 调用位置 | 接口/地址 | 环境变量 | 要求 | 配置状态 | 运行状态 | 说明 |
|---|---|---|---|---|---|---|---|---|---|
| PostgreSQL 正式数据库 | 基础设施 | 保存站点、关键词、内容、页面、收录、排名、任务和配置。 | 所有后台页面 / Prisma | DATABASE_URL | DATABASE_URL | 必填 | 已配置 | 已接入 | 没有数据库，后台只能退回演示数据，不能形成真实闭环。 |
| Redis / BullMQ 队列 | 基础设施 | 承载关键词拓展、内容生成、发布、收录、排名、优化等异步任务。 | Worker / BullMQ / 任务按钮 | REDIS_URL | REDIS_URL | 必填 | 已配置 | 已接入 | 没有 Redis，按钮可以入库但 Worker 队列无法稳定执行。 |
| AI 内容生成接口 | AI内容工厂 | 生成标题、大纲、正文、FAQ、Meta、Schema、标签和内链建议。 | AI内容工厂 / AI_CONTENT Worker | https://api.openai.com/v1/responses | OPENAI_API_KEY, OPENAI_MODEL | 核心必填 | 未配置 | 未配置时降级模板 | 没有 OPENAI_API_KEY 时系统会生成模板内容，但不是完整 AI 内容工厂。 |
| 目标站发布接口 | 发布中心 | 把文章、聚合页、工具页发布到对应独立站点或二级域名。 | 发布中心 / PUBLISH Worker | PUBLISH_WEBHOOK_URL 或 PUBLISH_OUTPUT_DIR | PUBLISH_WEBHOOK_URL, PUBLISH_OUTPUT_DIR | 上线必填 | 已配置 | 本地文件发布 | 真正多站独立发布时，每个目标站建议提供 Remote API/Webhook 或 SFTP。 |
| 必应 / IndexNow 提交 | 收录中心 | 向 IndexNow 支持的搜索引擎提交新URL和更新URL。 | 收录中心 / INDEXING_SUBMIT Worker | INDEXNOW_ENDPOINT | INDEXNOW_KEY, INDEXNOW_ENDPOINT | 推荐必填 | 未配置 | 未接入 | 需要在站点根目录放置 key 文件，keyLocation 要能被搜索引擎访问。 |
| Google Search Console | 收录中心 / 数据中心 | 接入 Google 搜索表现、Sitemap、URL Inspection 和索引覆盖数据，辅助技术 SEO 判断。 | 收录中心 / 排名中心 / 数据中心 / 接口中心 | Google Search Console API / URL Inspection API | GOOGLE_CLIENT_EMAIL, GOOGLE_PRIVATE_KEY, GOOGLE_SITE_URL, GOOGLE_SEARCH_CONSOLE_PROPERTY, GOOGLE_PROJECT_ID | 辅助推荐 | 未配置 | 未接入 | Google 普通文章不走 Indexing API 强推；这里用于 Search Console、Sitemap、URL Inspection 和搜索表现数据。 |
| 百度站长主动推送 | 收录中心 | 向百度提交 URL，提升百度抓取发现速度。 | 收录中心 / 站长平台配置 | 百度站长平台推送接口 | BAIDU_SITE, BAIDU_PUSH_TOKEN | 百度SEO必填 | 未配置 | 待接入专用提交器 | 当前 Worker 已有收录框架，但百度专用推送 provider 还需要按账号 token 接入。 |
| 360 搜索站长提交 | 收录中心 | 向 360 搜索提交 URL 和 Sitemap。 | 收录中心 / 站长平台配置 | 360站长平台提交接口 | SO360_SITE, SO360_PUSH_TOKEN | 360SEO必填 | 未配置 | 待接入专用提交器 | 需要你提供 360 站长平台站点和 token 后，再接入专用 provider。 |
| 搜狗站长提交 | 收录中心 | 向搜狗提交 URL 和 Sitemap。 | 收录中心 / 站长平台配置 | 搜狗站长平台提交接口 | SOUGOU_SITE, SOUGOU_PUSH_TOKEN | 搜狗SEO必填 | 未配置 | 待接入专用提交器 | 搜狗提交方式要按站长平台开放能力确认，后台先保留配置位。 |
| 排名查询数据源 | 排名中心 | 查询百度、360、搜狗、必应、Google 关键词排名，形成排名反馈优化。 | 排名中心 / RANKING_CHECK Worker | SERPAPI 或自建采集服务 | SERPAPI_KEY, SERPAPI_ENGINE, RANKING_API_URL | 排名闭环必填 | 未配置 | 未接入真实数据源 | 如果坚持自己采集，需要后续加采集代理、频控、验证码处理和结果解析。 |
| 竞品/外链采集数据源 | 竞品中心 / 外链中心 | 采集竞品关键词、页面、收录、排名、外链来源和锚文本。 | 竞品中心 / 外链中心 | 自建采集器或第三方数据API | COMPETITOR_API_URL, BACKLINK_API_URL | 规模化运营必填 | 未配置 | 待接入专用采集 Worker | 当前后台能配置和分发任务，但全网竞品/外链抓取还需要单独数据源。 |
| 10个目标站点 Remote API | 多站点发布 | 让每个独立站点接收页面、Sitemap、静态资源和刷新请求。 | 站点池 / 发布中心 / Sitemap | 每个站点的 /api/seo/publish 或 Webhook | SITE_API_BASE_URLS, SITE_API_TOKEN | 10站独立化必填 | 未配置 | 待接入多站发布适配器 | 二级域名跑通后，换成10个独立域名时这里必须接入。 |
接口分类
| 分类 | 数量 |
|---|---|
| 基础设施 | 2 |
| AI内容工厂 | 1 |
| 发布中心 | 1 |
| 收录中心 | 4 |
| 收录中心 / 数据中心 | 1 |
| 排名中心 | 1 |
| 竞品中心 / 外链中心 | 1 |
| 多站点发布 | 1 |
配置状态
| 状态 | 数量 |
|---|---|
| 已配置 | 3 |
| 未配置 | 9 |
队列状态
| 状态 | 数量 |
|---|---|
| waiting | 0 |
| active | 0 |
| completed | 10 |
| failed | 0 |
| paused | 0 |
站点接口配置
| 站点 | 域名 | 启用引擎 | 提交引擎 | 排名引擎 | 发布通道 |
|---|---|---|---|---|---|
| 国际期货主站 | www.peipei.net | 搜狗, 必应, 360搜索, 百度, Google | 搜狗, 必应, 360搜索, 百度 | 搜狗, 必应, 360搜索, 百度, Google | file, nextjs |
| SEO Site A | site-a.example.com | 百度, 360搜索, 搜狗, 必应, Google | 必应 | 百度, 360搜索, 搜狗, 必应, Google | file |
| SEO Site B | site-b.example.com | 百度, 360搜索, 搜狗, 必应, Google | 必应 | 百度, 360搜索, 搜狗, 必应, Google | file |
| SEO Site C | site-c.example.com | 百度, 360搜索, 搜狗, 必应, Google | 必应 | 百度, 360搜索, 搜狗, 必应, Google | file |
| SEO Site D | site-d.example.com | 百度, 360搜索, 搜狗, 必应, Google | 必应 | 百度, 360搜索, 搜狗, 必应, Google | file |
| SEO Site E | site-e.example.com | 百度, 360搜索, 搜狗, 必应, Google | 必应 | 百度, 360搜索, 搜狗, 必应, Google | file |
| 黄金站 | gold.peipei.net | 百度, 360搜索, 必应, 搜狗, Google | 百度, 360搜索, 必应, 搜狗 | 百度, 360搜索, 必应, 搜狗, Google | file, nextjs |
| 原油站 | oil.peipei.net | 360搜索, 搜狗, 百度, 必应, Google | 360搜索, 搜狗, 百度, 必应 | 360搜索, 搜狗, 百度, 必应, Google | file, nextjs |
| 恒指站 | hsi.peipei.net | 360搜索, 搜狗, 百度, 必应, Google | 360搜索, 搜狗, 百度, 必应 | 360搜索, 搜狗, 百度, 必应, Google | nextjs, file |
| 纳指站 | nasdaq.peipei.net | 搜狗, 百度, 360搜索, 必应, Google | 搜狗, 百度, 360搜索, 必应 | 搜狗, 百度, 360搜索, 必应, Google | nextjs, file |
| 外汇站 | forex.peipei.net | 百度, 搜狗, 360搜索, 必应, Google | 百度, 搜狗, 360搜索, 必应 | 百度, 搜狗, 360搜索, 必应, Google | nextjs, file |
| 非农站 | nfp.peipei.net | 百度, 360搜索, 搜狗, 必应, Google | 百度, 360搜索, 搜狗, 必应 | 百度, 360搜索, 搜狗, 必应, Google | file, nextjs |
| CPI站 | cpi.peipei.net | 百度, 搜狗, 360搜索, Google, 必应 | 百度, 搜狗, 360搜索, 必应 | 百度, 搜狗, 360搜索, Google, 必应 | file, nextjs |
| 技术分析站 | ta.peipei.net | 360搜索, 搜狗, 必应, 百度, Google | 360搜索, 搜狗, 必应, 百度 | 360搜索, 搜狗, 必应, 百度, Google | file, nextjs |
| 期货百科站 | wiki.peipei.net | 百度, 360搜索, 搜狗, 必应, Google | 百度, 360搜索, 搜狗, 必应 | 百度, 360搜索, 搜狗, 必应, Google | file, nextjs |
生产能力检查
| 能力 | 状态 | 说明 |
|---|---|---|
| AI 内容生成 | 未配置 | 未配置 DeepSeek/OpenAI，当前会降级为风控模板内容 |
| 目标站发布 | 已配置 | 已配置 PUBLISH_OUTPUT_DIR |
| 搜索引擎提交 | 未配置 | 未配置搜索引擎提交凭证，不会真实提交 |
| 排名查询 | 未配置 | 未配置 RANKING_API_URL 或 SERPAPI_KEY，不会真实查排名 |
| 后台访问保护 | 已配置 | 后台 Basic Auth 未启用，可通过 ADMIN_AUTH_ENABLED=true 开启 |
接口中心输出物说明
API Map
完整列出站点需要接入的 API、用途、变量和调用位置。
Env Check
自动检查服务器环境变量是否存在，敏感值不展示。
Test Result
数据库、Redis 可直接测，外部 API 默认先入队测试。
Pending Work
明确标注百度、360、搜狗、Google、竞品外链等待接入项。