一为主题采集一为主题网址 一为主题一键更新图标

本套工具主要用于 WordPress 一为导航主题的网址采集与自动维护，包含“一为导航采集接口”和“一键更新图标”两个插件，可配合高铁采集器、火车头采集器等软件使用。

主要功能

• • 通过 WordPress REST API 自动发布一为导航网址。

• • 支持发布网址标题、正文、简介、分类、标签和目标链接。

• • 自动创建不存在的网址标签。

• • 自动把正文中的外站标签链接转换为本站标签链接。

• • 根据目标网址检测重复内容，避免反复收录。

• • 发布完成后自动获取网站图标。

• • 图标接口失败时自动尝试备用接口。

• • 图标使用远程接口地址，不下载到本地媒体库。

包含的插件

1. IPI OneNav Collector API

为一为导航的 sites 文章类型开放采集所需的 REST 字段，支持网址、简介、正文和文字标签发布，并提供重复网址检测功能。

2. IPI 一为导航一键更新图标

发布网址后自动检测并写入远程图标地址，同时提供后台批量更新、强制更新和单条更新功能。默认图标接口无法获取时，会自动尝试其他备用接口。

安装方法

1. 1. 进入 WordPress 后台。

1. 1. 打开“插件 → 安装插件 → 上传插件”。

1. 1. 分别上传两个 ZIP 安装包。

1. 1. 安装完成后启用插件。

1. 1. 进入“网址 → 一键更新图标”检查图标接口设置。

采集发布接口

默认发布地址为：

/wp-json/wp/v2/sites

推荐使用 WordPress“应用程序密码”进行 REST API 身份验证，不要直接使用网站登录密码。

高铁采集器 POST 参数示例：

title=[标签:标题]&status=draft&content=[标签:内容]&favorites[]=分类ID&meta[_sites_link]=[标签:原始网址]&ipi_description=[标签:介绍]&ipi_tags=[标签:标签]

首次使用建议保持 status=draft，先发布为草稿进行检查。确认标题、正文、简介、分类、标签、网址和图标均正常后，再改成 status=publish 正式发布。

重复网址检测

插件会根据一为导航的目标网址字段 _sites_link 检查重复记录。发现相同网址时，接口会返回：

HTTP 409
duplicate_site_url

采集器可将该结果设置为“重复或跳过”，避免重复发布。

标签链接自动转换

插件不会写死采集来源域名，也不会写死目标网站域名。只要正文中的链接文字与本次采集的标签名称相同，就会自动替换成当前 WordPress 网站生成的真实标签链接。

因此更换采集来源网站或迁移一为导航域名后，接口插件仍可继续使用。需要注意的是，不同来源网站的 HTML 结构不同，标题、正文、简介、网址和标签的采集规则仍需根据页面源码重新设置。

图标更新说明

图标插件会按顺序检测多个 Favicon 接口，并选择第一个能够正常返回图标的接口。插件只把远程图标地址写入一为导航，不占用本地媒体库空间。

已有网址可以进入“网址 → 一键更新图标”，选择“强制更新全部图标”进行批量处理；以后通过 REST 接口发布的新网址会自动设置图标。

使用提醒

• • 批量发布前请先测试一条草稿。

• • 分类 ID 必须使用目标网站中的真实分类 ID。

• • 请勿在公开文章、截图或配置文件中泄露应用程序密码和 Authorization 授权码。

• • 采集和转载内容前，请确认拥有相应内容的使用授权。

适用场景：一为导航网址采集、网址批量发布、自动标签管理、重复网址过滤、网站图标批量更新。