Hexo Seo Submit

自动或手动提交您的网站信息至搜索引擎（谷歌，bing，百度）。支持配置 GitHub Actions 或 Coding Jenkins 来适配不同平台的 CI

star 后使用，效果更佳~~

📦 Install

npm install hexo-seo-submit

yarn add hexo-seo-submit

pnpm add hexo-seo-submit

🔨 Usage

在 hexo/_config.yml 中配置 hexo-seo-submit

hexo-seo-submit:
  sortBy: updated # created | updated, default created
  count: 2  # set all engine count, default 10
  fileRootPath: hexo-seo-submit # will generate in root/public/fileRootPath, default '', root/public/
  CI:
    enable: true
    cron: 0 4 * * *
    platform: github # github | coding, default gitHub
    branch: main # actions trigger branch, default master

  baidu:
    enable: true # default false
    path: baidu.txt # default google.txt
    count: 1
    token: you baidu token
  google:
    enable: true
    path: google-url.txt # default google.txt
    # find path in root
    accountKeysJSonFile: google.json  # path.join(process.cwd(), path)
    count: 2
    # maybe required
    proxy: http://127.0.0.1:7890
  bing:
    enable: true
    apiKey: your bing api key
    sortBy: created # default created
    path: bing.json

github 中使用

如果在 github actions 中运行，可如下简化

hexo-seo-submit:
  CI:
    enable: true
  baidu:
    enable: true
  google:
    enable: true
  bing:
    enable: true

注意！生成后的 actions 文件路径为：public/.github/workflows/hexo-seo-submit.yml，由于点开头的文件或文件夹默认被 hexo-deployer-git忽略，你需要在 _config.yml 的 deploy 中

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

配置环境变量，去除引号直接粘贴至 即可

Name	Value	说明
baidu_token		百度的 token
bing_apikey		必应的 apikey
google_private_key	-----BEGIN PRIVATE KEY-----\n.....\n-----END PRIVATE KEY-----\n	谷歌的 private_key，注意：粘贴时请去除引号
google_client_email		谷歌的 client_email

coding 中使用

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

1. 在项目 => 持续集成 => 构建计划 中创建构建计划

2. 创建完后点 去设置 在基础信息中，将 配置来源 选择为 使用代码库中的 Jenkinsfile。节点配置池 需要选择可以连接 google 的节点，若无此需求可随意

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

4. 在 变量与缓存 中添加环境变量

需要注意的是在 coding 中 google_private_key 需要 引号

Name	Value	说明
baidu_token		百度的 token
bing_apikey		必应的 apikey
google_private_key	"-----BEGIN PRIVATE KEY-----\n.....\n-----END PRIVATE KEY-----\n"	谷歌的 private_key，注意：粘贴时需要引号
google_client_email		谷歌的 client_email

本地 deploy 时 push 到搜索引擎

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

参数

hexo-seo-submit 配置参数描述

参数	类型	描述	默认值
hexo-seo-submit		根配置项
sortBy	string	排序依据，created 或 updated ，优先使用引擎中的字段	created
count	integer	生成 url 的数量，优先使用引擎中的字段	10
fileRootPath	string	生成文件的根路径，将生成在 root/public/fileRootPath 目录，如果你不想分散在 public 目录中，则可以使用该字段	''，即 root/public/
CI	object	持续集成配置
CI.enable	boolean	是否启用持续集成	false
CI.cron	string	CRON 表达式，指定任务调度时间，注意在 actions 中的时区，且仅在 platform 为 github 时有效	0 4 * * *
CI.platform	string	github 或 coding	github
CI.branch	string	触发操作的分支名称，仅在 github 时有效	master
baidu	object	百度搜索引擎配置
baidu.enable	boolean	是否启用百度搜索引擎	false
baidu.path	string	生成 urls 文件的路径	baidu.txt
baidu.count	integer	生成 urls 的数量
baidu.sortBy	string	排序依据
google	object	谷歌搜索引擎配置
google.enable	boolean	是否启用谷歌搜索引擎	true
google.path	string		google.txt
google.accountKeysJSonFile	string	谷歌账户密钥文件路径，默认 root 目录寻找	google.json
google.count	integer
google.sortBy	integer
google.proxy	string	https proxy，如果你是 clash 一般默认为 http://127.0.0.1:7890
bing	object	必应搜索引擎配置
bing.enable	boolean	是否启用必应搜索引擎	true
bing.apiKey	string	必应搜索引擎的 API 密钥
bing.sortBy	string
bing.path	string		bing.json

使用命令执行

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

# 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 -mail <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 -kf examples/files/google-keys.json

注意事项

1. 搜索引擎中的 path 更改时注意后缀应于默认值保持一致
2. google 连接缓慢？请使用 proxy 字段
3. google push 失败？请注意 google_private_key 的格式

申请凭证

Baidu

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

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

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

Google

1. 进入 Web Search Indexing API，选择 项目 并启用 API，没有可新建。

2. 点击 管理 按钮，进入 凭据 菜单，选择 创建凭据 => 服务账号

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

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

内容如下，在 github secrets 中分别对应 google_private_key、google_client_email 注意，在 github 中，复制 private_key 时不需要 引号，在 coding 中复制需要 引号

{
  "private_key": "-----BEGIN PRIVATE KEY-----\nxxxxxx\n-----END PRIVATE KEY-----\n",
  "client_email": "[e-mail]"
}

5. 打开 Google Search Console，设置 => 用户和权限 => 添加用户，邮箱为上述 json email，权限请选择 拥有者

6. 打开 https://console.cloud.google.com/apis/api/indexing.googleapis.com/metrics，选择你的项目，进行验证

Bing

1. 打开 https://www.bing.com/webmasters/home，选择谷歌账号登录（可同步 Google Search Console，无需再验证）

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

3. URL 提交菜单中可验证

参考

hexo-seo-submit docs

Hexo-SEO-AutoPush

hexo-url-submission