前言

hexo-seo-submit 插件，支持在 Github 和 Coding 平台中每天自动提交你的最新文章链接（或本地手动）至搜索引擎，让搜索引擎更快的收录你的文章。同样也支持命令行调用，支持多种场景~

插件由 typescript 编写，支持自动部署。有编码能力且有需求的话可以提 PR 哦~

hexo-seo-submit

pnpm dlx corgii@latest <folder-name>
# or
pnpm dlx corgii@latest

安装

npm install hexo-seo-submit

yarn add hexo-seo-submit

pnpm add hexo-seo-submit

使用

更改配置后，需要 hexo generate 后部署

在 github actions 中使用

默认触发分支为 master，可自行更改

_config.yml
hexo-seo-submit:
  CI:
    # cron: 0 4 * * *
    # branch: master # default master
    enable: true
  baidu:
    enable: true
  google:
    enable: true
  bing:
    enable: true

deploy:
  type: git
  repo: https://github.com/<username>/<project>
  # 注意~  
  ignore_hidden: false # 忽略隐藏文件及文件夹(目录)

配置环境变量

复制申请凭证中获取的值，注意粘贴时需去除引号。name 可以直接复制表格

谷歌的 private_key 在带引号或不带引号复制粘贴时，在 actions 变量输入框中将表现不一（如下的图一和图二）。带引号复制粘贴会在使用时转义 换行符（\n => \\n or \\\\n），目前理论解决该问题，若遇到 routines::unsupported 可尝试直接复制粘贴引号内的内容~

图一：复制粘贴引号内的内容
图二：复制粘贴包含引号内容，再去除引号

在 Coding 中使用

启用后，运行 hexo generate 会在 public 下生成 Jenkinsfile。与 github CI 不同的是，触发规则和构建计划需要手动配置。

_config.yml
hexo-seo-submit:
  CI:
    enable: true
    platform: coding
  baidu:
    enable: true
  google:
    enable: true
  bing:
    enable: true

创建 构建计划

项目 => 持续集成 => 构建计划 创建一个新的构建计划。（注意~ 请选择使用代码库中的 Jenkinsfile）

配置节点池

如果你需要提交至 Google 的话，需要在构建计划设置 基础信息 中选择可以连接 Google 的节点

配置触发

在 触发规则 中可配置触发条件，例如：main 分支提交时触发和定时触发等。注意点保存

配置变量

变量都不需要引号，复制粘贴 google_private_key 时需保持格式正确，建议连带引号复制，再去除即可

本地 deploy

本地执行 hexo deploy 时，hexo-seo-submit 会将 public 中生成的 urls 提交至搜索引擎、
你需要将申请的 Baidu token、Bing apikey、Google json 填入。如果你的网络环境连接 google 较慢的话，可以尝试使用 proxy 字段，支持 https。
最后在 deploy 中配置启用该插件即可。

hexo-seo-submit:
  baidu:
    enable: true
    token: you baidu token
  google:
    enable: true
    accountKeysJSonFile: google.json
    proxy: http://127.0.0.1:7890
  bing:
    enable: true
    apiKey: your bing api key

# 注意在此处配置
deploy:
  - type: hexo-seo-submit

详细参数

hexo-seo-submit 配置参数描述

命令行使用

help

npx hexo-seo-submit -h
# or
npx hexo-seo-submit google -h

command

# baidu
$ npx hexo-seo-submit baidu -t <your baidu token> -s https://ksh7.com -f baidu.txt

# bing
# must .json file, Eg: { siteUrl: 'https://ksh7.com', urlList: ['xxx'] }
$ npx hexo-seo-submit bing -k <you bing api key> -f examples/files/bing.json

# google
# use Environment variables
$ export PRIVATE_KEY="-----BEGIN PRIVATE KEY-----\n..."
$ npx hexo-seo-submit google -f examples/files/baidu.txt -p http://127.0.0.1:7890 -m <your client_email here> -key "$PRIVATE_KEY"

# use json file
$ npx hexo-seo-submit google -f examples/files/baidu.txt -p http://127.0.0.1:7890 -a examples/files/google-keys.json

注意事项

1. 搜索引擎中的 path 更改时注意后缀应于默认值保持一致
2. google 连接缓慢？请使用 proxy 字段
3. google push 失败？请注意 google_private_key 的格式
4. 插件在CI中会抛出错误，但不会终止任务，首次需观察日志输出。

申请凭证

百度

百度站长平台 => 普通收录 => 资源提交 中得到 token

http://data.zz.baidu.com/urls?site=https://ksh7.com&token=***********

效果查看

一般 T+1，或查看 actions 中的运行日志。

Google

启用 Web Search Indexing API

创建 服务账号

点击 管理 按钮（API启用后即可看到），进入 凭据 菜单，选择 创建凭据 => 服务账号

填写 服务账号ID ，服务名称 可选，随后可直接点击 完成

创建 密钥

点击创建好的服务账号，点击 密钥 => 添加密钥，选择 创建新密钥，选择 JSON 格式，点击 创建，下载 json 文件

内容如下，在 github secrets 中分别对应 google_private_key、google_client_email。如果你为本地部署的话，该文件将是 accountKeysJSonFile 字段的值。
注意，在 github 中，复制 private_key 时不需要 引号，在 coding 中复制需要 引号

{
  "private_key": "-----BEGIN PRIVATE KEY-----\nxxxxxx\n-----END PRIVATE KEY-----\n",
  "client_email": "googleindexing@elated-guild-298003.iam.gserviceaccount.com"
}

授权 Google Search Console

验证

Bing

关联资源

API 密钥

点击右上角的 设置 => API 访问 => 复制 API 密钥 即可

验证

URL 提交菜单中可验证

结

star star ~

hexo-seo-submit