## 项目简介

**百度搜索资源小工具**是一款专为 Z-BlogPHP 博客系统设计的百度搜索资源提交插件，帮助站长快速将网站内容推送给百度搜索引擎，提升网站收录效率和曝光度。

---

## 核心功能架构

### 功能矩阵

| 功能模块 | 技术实现 | 核心价值 |
|---------|---------|---------|
| **普通收录** | 调用百度链接提交 API | 实时推送文章链接 |
| **快速收录** | 调用百度原创收录接口 | 提升时效性内容曝光 |
| **小程序收录** | OAuth 2.0 + 小程序 API | 多维度内容分发 |
| **自动推送** | 百度 JS 代码注入 | 被动抓取优化 |
| **Sitemap 生成** | XML 动态生成 | 结构化站点地图 |
| **每日自动推送** | 定时任务 + 额度管理 | 智能额度利用 |

---

## 技术实现深度剖析

### 1. 插件钩子机制设计

插件通过 Z-BlogPHP 的钩子系统实现自动化推送：

```php
function ActivePlugin_baiduziyuan() {
    Add_Filter_Plugin('Filter_Plugin_PostArticle_Core','baiduziyuan_PostArticle_Core');
    Add_Filter_Plugin('Filter_Plugin_PostArticle_Succeed','baiduziyuan_PostArticle_Succeed');
    Add_Filter_Plugin('Filter_Plugin_DelArticle_Succeed','baiduziyuan_DelArticle_Succeed');
    Add_Filter_Plugin('Filter_Plugin_PostPage_Core','baiduziyuan_PostArticle_Core');
    Add_Filter_Plugin('Filter_Plugin_PostPage_Succeed','baiduziyuan_PostArticle_Succeed');
    Add_Filter_Plugin('Filter_Plugin_Edit_Response3','baiduziyuan_Edit_Response3');
    Add_Filter_Plugin('Filter_Plugin_Zbp_MakeTemplatetags','baiduziyuan_Zbp_MakeTemplatetags');
}
```

**设计思路**：通过在文章发布、删除、编辑等关键节点注入钩子，实现自动化推送流程，无需人工干预。

### 2. 百度链接提交 API 封装

核心推送函数实现：

```php
function baiduziyuan_Post($article, $state = 'urls', $type = null) {
    global $zbp;
    
    // URL 标准化处理
    $weburl = $zbp->host;
    $weburl = str_replace(['http://', 'https://', '/'], '', $weburl);
    
    // 构建推送链接列表
    $urls = [$article->Url];
    
    // 构建 API 请求
    $api = "http://data.zz.baidu.com/{$state}?site={$weburl}&token={$zbp->Config('baiduziyuan')->token}";
    
    // 快速收录特殊处理
    if ($type == 'original') {
        $api .= "&type=daily";
    }
    
    // 发起 HTTP 请求
    $ajax = Network::Create();
    $ajax->open('POST', $api);
    $ajax->setRequestHeader('Content-Type', 'text/plain');
    $ajax->send(implode("\n", $urls));
    
    return $ajax->responseText;
}
```

**技术要点**：
- 支持普通收录与快速收录两种模式切换
- 通过 `type=daily` 参数实现快速收录通道
- 使用纯文本格式提交 URL 列表，符合百度 API 规范

### 3. 百度小程序 OAuth 2.0 集成

小程序提交涉及完整的 OAuth 认证流程：

```php
function baiduziyuanapp_Post($id, $type) {
    global $zbp;
    
    // Step 1: 获取 Access Token
    $client_id = $zbp->Config('baiduziyuan')->appkey;
    $client_secret = $zbp->Config('baiduziyuan')->appsecret;
    $url = "https://openapi.baidu.com/oauth/2.0/token?grant_type=client_credentials&client_id={$client_id}&client_secret={$client_secret}&scope=smartapp_snsapi_base";
    
    $ajax = Network::Create();
    $ajax->open('GET', $url);
    $ajax->send();
    $response = json_decode($ajax->responseText, true);
    $access_token = $response['access_token'];
    
    // Step 2: 提交小程序链接
    $api = "https://openapi.baidu.com/rest/2.0/smartapp/access/submitsitemap/api?access_token={$access_token}";
    
    $ajaxa = Network::Create();
    $ajaxa->open('POST', $api);
    $data['type'] = $type;           // 0=周级, 1=天级, 2=小时级
    $data['url_list'] = $zbp->Config('baiduziyuan')->apppath . $id;
    $ajaxa->send($data);
    
    // Step 3: 处理响应
    if ($response['errno'] == 0) {
        $zbp->SetHint('good', '百度小程序快收推送成功');
    }
}
```

**多级别提交策略**：

| 级别 | type 值 | 适用场景 |
|-----|--------|---------|
| 周级 | 0 | 历史文章、低频更新内容 |
| 天级 | 1 | 常规文章、中等时效内容 |
| 小时级 | 2 | 热点新闻、时效性强内容 |

### 4. 每日自动推送机制

针对百度每日推送额度限制，设计了智能额度利用机制：

```php
// api.php - 核心逻辑
$sdc = GetVars('sdc');
if ($sdc == $zbp->Config('baiduziyuan')->code) {
    // Step 1: 查询未提交文章
    $sql = $zbp->db->sql->get()
        ->select($zbp->table['Post'])
        ->where(['=', 'baiduis', '0'])
        ->orderBy(['log_PostTime' => 'desc'])
        ->limit($znum)
        ->sql;
    
    // Step 2: 批量推送
    $ajax->send(implode("\n", $urls));
    $result = json_decode($ajax->responseText);
    
    // Step 3: 智能补送剩余额度
    if ($result->remain) {
        $today = $result->remain;
        // 根据剩余额度继续推送
    }
    
    // Step 4: 标记已提交状态
    $sql = $zbp->db->sql->get()
        ->update($zbp->table['Post'])
        ->where('in', 'log_ID', $ids)
        ->data(['baiduis' => 1])
        ->query;
}
```

**额度管理策略**：
- 使用 `baiduis` 字段追踪提交状态
- 根据百度返回的 `remain` 字段智能补送
- 支持循环推送，确保所有文章都能被提交

### 5. Sitemap 生成模块

动态生成符合 sitemap 标准的 XML 文件：

```php
// sitemap.php
$xml = new SimpleXMLElement('<?xml version="1.0" encoding="utf-8"?><urlset />');
$xml->addAttribute('xmlns', 'http://www.sitemaps.org/schemas/sitemap/0.9');

// 添加首页
$url = $xml->addChild('url');
$url->addChild('loc', $zbp->host);

// 按配置添加分类、文章、页面、标签
if ($zbp->Config('baiduziyuan')->iscategory) {
    foreach ($zbp->categorys as $c) {
        $url = $xml->addChild('url');
        $url->addChild('loc', $c->Url);
    }
}

// 写入文件
file_put_contents($zbp->path . 'sitemap.xml', $xml->asXML());
```

---

## 数据库设计

插件使用自定义字段 `baiduis` 追踪文章提交状态：

```sql
-- 安装时添加字段
ALTER TABLE `zbp_post` ADD COLUMN `baiduis` integer DEFAULT '0'

-- 提交后更新状态
UPDATE `zbp_post` SET `baiduis` = 1 WHERE `log_ID` IN (1, 2, 3)

-- 重置状态（循环推送）
UPDATE `zbp_post` SET `baiduis` = 0
```

---

## 安全机制

### 1. CSRF 防护

所有表单提交均包含 CSRF Token：

```php
<input type="hidden" name="csrfToken" value="<?php echo $zbp->GetCSRFToken(); ?>">
```

### 2. 权限验证

```php
if (!$zbp->CheckRights('root')) {
    $zbp->ShowError(6);
    die();
}
```

### 3. API 密钥保护

通过密钥验证机制保护自动推送接口：

```php
$sdc = GetVars('sdc');
if ($sdc == $zbp->Config('baiduziyuan')->code) {
    // 执行推送逻辑
}
```

---

## 配置与使用

### 基础配置

| 参数 | 说明 | 获取方式 |
|-----|------|---------|
| Token | 百度搜索资源平台推送令牌 | 百度搜索资源平台 |
| App Key | 百度小程序应用密钥 | 百度智能小程序后台 |
| App Secret | 百度小程序应用密钥 | 百度智能小程序后台 |
| 每日额度 | 每日最大推送数量 | 根据站点资源配置 |
| 密钥 | API 访问密钥（自定义） | 用户自行设置 |

### 推送状态码说明

| 返回结果 | 含义 | 处理建议 |
|---------|-----|---------|
| `{"remain":4999948,"success":5}` | 推送成功 | 正常 |
| `{"error":401,"message":"token is not valid"}` | Token 无效 | 重新获取 Token |
| `{"error":400,"message":"over quota"}` | 今日额度用尽 | 次日重试 |
| `{"remain":4999948,"success":0}` | 推送地址不匹配 | 检查域名配置 |

---

## 技术亮点

1. **钩子驱动架构**：通过 Z-BlogPHP 钩子系统实现自动化流程
2. **多维度推送策略**：支持普通收录、快速收录、小程序多级别提交
3. **智能额度管理**：自动利用每日剩余推送额度
4. **模块化设计**：功能解耦，便于扩展和维护
5. **安全防护**：完整的 CSRF、权限、密钥验证机制

---

## 总结

百度搜索资源小工具通过系统化的技术方案，帮助 Z-BlogPHP 站长高效管理百度搜索资源提交工作。其核心价值在于：

- **自动化**：文章发布时自动触发推送
- **智能化**：智能利用推送额度，最大化收录效率
- **多渠道**：覆盖普通收录、快速收录、小程序等多种渠道
- **易配置**：直观的管理界面，一键配置

如果您正在使用 Z-BlogPHP，这款插件将是提升网站 SEO 效果的得力助手！

百度搜索资源小工具是一款专为 Z-BlogPHP 博客系统设计的百度搜索资源提交插件，帮助站长快速将网站内容推送给百度搜索引擎，提升网站收录效率和曝光度。

百度搜索资源小工具：为 Z-BlogPHP 打造的搜索引擎优化利器

前端

开发工具

百度搜索资源小工具是专为Z-BlogPHP设计的SEO插件，支持自动推送文章至百度搜索引擎，提升收录效率。具备普通收录、快速收录、小程序推送三大功能，采用钩子机制实现自动化流程，内置智能额度管理，每日自动推送未收录内容。插件支持XML站点地图生成，提供完整安全防护机制，是Z-BlogPHP站长提升网站SEO效果的必备工具。

数据库

OAuth

2026采购季 | AI焕新·智启新局

热销域名限时优惠，新客首年免费！


domain

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

百度搜索资源小工具是专为Z-BlogPHP设计的SEO插件，支持自动推送文章至百度搜索引擎，提升收录效率。具备普通收录、快速收录、小程序推送三大功能，采用钩子机制实现自动化流程，内置智能额度管理，每日自动推送未收录内容。插件支持XML站点地图生成，提供完整安全防护机制，是Z-BlogPHP站长提升网站SEO效果的必备工...

百度搜索资源小工具：为 Z-BlogPHP 打造的搜索引擎优化利器-腾讯云开发者社区-腾讯云

百度搜索资源小工具：为 Z-BlogPHP 打造的搜索引擎优化利器

百度搜索资源小工具：为 Z-BlogPHP 打造的搜索引擎优化利器

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐