# Baidu URL Push Plugin for BeikeShop

 

## 功能介绍

 

百度URL推送插件可以通过百度站长平台的主动推送接口，自动将新上架的产品和新发布的文章URL推送给百度，加速百度搜索引擎的收录速度。

 

## 主要功能

 

- **自动推送**：新产品上架、新文章发布时自动推送给百度

- **全量推送**：一键推送所有产品或所有文章

- **推送记录**：详细的推送日志记录

- **剩余配额显示**：显示当天剩余可推送URL数量

 

## 安装步骤

 

1. 将插件目录放置在 `plugins/BaiduPush/` 目录下

 

2. 在后台「插件管理」中启用插件

 

3. 进入「百度URL推送」设置页面，配置站点和Token

 

## 配置说明

 

### 1. 启用自动推送

开启后，新产品上架和文章发布时将自动推送给百度。

 

### 2. 站点域名

在百度搜索资源平台验证的站点域名，例如：`www.example.com`

- 不需要添加 `http://` 或 `https://`

- 必须是已验证的站点

 

### 3. 准入密钥（Token）

在百度搜索资源平台申请的推送用的准入密钥。

 

**获取方式：**

1. 登录[百度搜索资源平台](https://ziyuan.baidu.com/)

2. 添加并验证您的站点

3. 进入「链接提交」-「自动提交」-「主动推送」

4. 复制准入密钥（token）

 

### 4. 自动推送选项

- **自动推送产品**：新产品上架时自动推送

- **自动推送文章**：新文章发布时自动推送

 

## 使用说明

 

### 自动推送

配置完成后，系统会在以下情况自动推送URL：

- 新产品上架时

- 新文章发布时

- 产品或文章更新时

 

### 推送所有内容

1. 进入「百度URL推送」设置页面

2. 点击「推送所有产品」或「推送所有文章」按钮

3. 确认推送操作

4. 等待推送完成并查看结果

 

## API 接口

 

### 推送结果返回格式

 

**成功返回：**

```json

{

    "remain": 99998,

    "success": 2,

    "not_same_site": [],

    "not_valid": []

}

```

 

**失败返回：**

```json

{

    "error": 401,

    "message": "token is not valid"

}

```

 

### 错误码说明

 

| 错误码 | 说明 |

|--------|------|

| 200 | 推送成功 |

| 400 | 请求参数错误 |

| 401 | Token 无效或过期 |

| 403 | 站点未验证或无权限 |

| 500 | 服务器内部错误 |

 

## 注意事项

 

1. **推送限制**：百度对每日推送URL数量有限制，请合理使用

2. **站点验证**：必须先在百度搜索资源平台完成站点验证

3. **URL 格式**：推送的URL必须是已验证站点的URL

4. **重复推送**：同一URL可以多次推送，百度会自动去重