OXIRANKER DEVELOPER DOCS

OxiRanker 文档

一个清晰的文档中心,用于将你的网站连接到 OxiRanker 服务。先从 WordPress 集成或 API 集成开始,然后按照指南逐步完成。

官方文档Full-feature V1适用于网站所有者、开发者和集成团队
文档菜单
从菜单中选择一个指南。此页面是 OxiRanker 的主文档中心。
WordPress 服务

WordPress 服务

将你的网站连接到 OxiRanker WordPress 插件,接收 generated articles,并将其作为 WordPress posts 发布。

Domain
已验证
内容
就绪
WordPress
插件
重要存储提示

OxiRanker 不是 destination website 的 permanent hosting

OxiRanker 不为 destination website 的 content、images 或 exported files 提供 permanent hosting 保证。OxiRanker 不是 user-content hosting service,generated content、cover images、Open Graph images 或 output files 可能不会在 OxiRanker infrastructure 上保留超过 90 天。

因此,在收到 output 后,destination website 必须将 final article、images、SEO data、Open Graph data 和 Schema data 存储在自己的 database、server、storage 或 CDN 中,并且不应依赖 OxiRanker URLs 进行 public display。

培训视频

连接培训视频

在连接 WordPress 或实现 API 集成之前,将此视频作为可视化 walkthrough 使用。

下载 OxiRanker WordPress 插件

下载 WordPress 插件文件,并从 WordPress dashboard 的 Upload Plugin 部分安装。

插件文件
oxiranker.zip
下载插件

下载插件,将其 upload 到 WordPress,activate,然后使用你的 Domain ID 和 Connect Token 进行连接。

步骤 01

在 OxiRanker 注册并创建 domain

首先,在 OxiRanker 注册,sign in 到你的 account,然后在 Domains 部分点击 Add Domain。

正确的 domain 格式

在 Domain name 字段中,只输入 root domain。地址不能包含 http、https 或 www。

example.com

错误格式

不要在 domain 字段中输入这些格式。

https://example.com
http://example.com
www.example.com
创建 domain 后
如果 domain 格式 valid,OxiRanker 会创建 domain,并将你带到 domain ownership verification step。
步骤 02

验证 domain 所有权

在此 step 中,你必须证明该 domain 属于你,或者你拥有管理它的 access。

DNS TXT

推荐

向 domain DNS 添加 TXT record。对于 Cloudflare,这通常是最简单的 method。

DNS Name:
_yourdomain-verification.example.com

TXT Value:
acb1****29803

HTTP File

在你的网站 .well-known path 中放置一个 text file,以便 OxiRanker 可以验证。

File URL:
https://example.com/.well-known/yourdomain-verification.txt

File Content:
220daaa37****42730f27

Meta Tag

在你的网站 homepage 的 head section 中放置一个 meta tag。

<meta name="yourdomain-verification" content="190208d****d275b65" />
重要 DNS 说明
添加 DNS record 后,尤其是在 Cloudflare 中,你可能需要等待 2 到 3 分钟。然后在同一个 OxiRanker page 上点击 Confirm。
Verification token 有效期
Domain verification values 有 time limit。目前,verification values 通常 valid 1440 minutes。
步骤 03

验证第一个 domain 后获得免费 token

验证第一个 domain 后,OxiRanker 会向你的 account 添加 1000 free tokens,用于 initial testing。

仅适用于第一个 domain
此 gift 只会添加给第一个 verified domain,不会为后续 domains 再次添加。
步骤 04

配置语言和 Blog URL

在 Blog URLs 部分,定义你的网站是 single-language 还是 multilingual,以及 generated articles 应使用哪些 languages。

选择语言

OxiRanker 支持 24 languages。你可以根据网站结构选择一种或多种 languages。

输入 Blog URL

对于每种 language,输入该 language 的 blog URL。如果你的网站是 multilingual,请分别输入每个 language path。

https://example.com/fa/blog
https://example.com/en/blog
URL structure
如果你的网站结构不同,请输入你网站真实的 blog URL。重点是 final URL 必须是 articles 要 publish 的 path。
步骤 05

为每种 language 添加 keywords

在 Keywords tab 中,为每种 language 添加至少 3 个、最多 50 个 keywords。

主要规则

每种 language 的 keywords 必须使用同一种 language 输入。如果 article language 是 English,那么 keywords 也必须是 English。

如何添加 keywords

输入每个 keyword 后,按 Enter 添加。完成所有 keywords 后,点击 Save。

常见错误
如果你为 English language 输入 Turkish keywords,English content 中可能会出现 Turkish phrases。Keyword language 必须与 article language 匹配。
步骤 06

完成 domain Article Profile

Article Profile 会告诉 OxiRanker 你的 brand 是什么、为谁写作、应使用什么 tone,以及应避免哪些 topics。

Industry

定义 market 或 business category。示例:Dubai 的 real estate consulting 和 property buying and selling。

Business description

说明 business 销售什么、服务谁、如何运作,以及它的差异点。

Audience

定义 content 应面向谁。每个 audience 都可以单独 save。

Tone

控制 generated content 的 style 和 voice,例如 formal、educational、simple、technical 或 sales-oriented。

Content goal

定义 articles 应达到什么目标,例如吸引 customers、增加 traffic 或教育 users。

禁止主题

任何 brand 不应讨论或不应与之关联的内容,都在此处输入。

Optional CTA

CTA 指你希望 reader 在阅读 article 后执行的 action。如果不确定哪种 text suitable,最好将此 field 留空。

Multilingual profile
如果你的网站是 multilingual,只需用一种 language 完成 profile。OxiRanker 可以基于同一个 profile 为其他 languages 准备所需 versions。
步骤 07

内部链接和外部链接

OxiRanker 可以在 articles 内 intelligent 应用 internal links 和 external links。

Internal links

此 option 默认 enabled,最好保持 enabled。Internal linking 帮助 search engines 更好地理解你网站的 content structure。

在第一篇 article 中,通常不会创建 internal links,因为还没有 previous article。从第二篇 article 开始,system 可以执行 internal linking。

External links

External links 会添加到 official 和 trusted sources,并被 marked 为 nofollow,以免 SEO authority 被 unintentionally 传递。

步骤 08

用 AI 检查 profile quality

完成 Article Profile 后,OxiRanker 会 review profile quality。

85+
save 所需的 minimum score
95
改进后通常达到的 excellent score
AI
每个 field 的 professional suggestions
如果 score 低于 85
System 不允许 final saving,并会为每个 problematic field 显示 explanations 和 improvement suggestions。你可以 apply suggestions 后再次 save。
步骤 09

连接 Telegram 以发送 article summaries

Profile 成功 save 后,你可以 enable 将 article summaries 发送到 Telegram channel。

1

添加 bot

将 @Oxiranker_Bot 添加到你的 Telegram channel,并将其设为 Admin。

2

输入 channel username

输入带 @ 的 channel name。示例:@my_channel

3

Enable summary delivery

注册 valid channel 后,enable article summary delivery。

Telegram 优势
如果 enabled,在 content generation 后,article summary 会带着 image 和 link 发送到 Telegram channel。这可以增强指向你网站的 traffic paths。
步骤 10

配置 automatic article engine

在 Automatic article generation tab 中,你可以管理 automatic article generation engine。

Smart topic selection

System 使用 keywords 和 Article Profile 来选择 suitable、unique 且 publishable 的 topics。

Brand-aware generation

在 article generation 期间,会遵守 tone、audience、content goal 和 brand restrictions。

Scheduled publishing

Monthly capacity 会在整个月中分配,使 content publishing 看起来更 natural 且 consistent。

Monthly capacity

7 articles / month
10 articles / month
15 articles / month
30 articles / month

30 articles 表示几乎每天一篇 article。15 articles 表示几乎隔天一篇。10 articles 表示大约每两到三天一篇。7 articles 表示大约每三到四天一篇。

Article length 和 image

Article length 可以是 Short、Standard 或 Long。Standard 对大多数网站来说是 balanced choice。

Article images 可以 enabled 或 disabled,image theme 可以选择 Light 或 Dark。

步骤 11

从 Generate 创建第一篇 article

准备好 domain 后,打开 Generate menu,选择 domain,然后点击 New Content 或 New Article。

1

Language

每个 content request 只选择一种 language。

2

Topic

写一个清晰的 topic。Source URL 是 optional。

3

Image

Enable 或 disable image,并选择 Light 或 Dark theme。

4

Payment 和 generation

Cost 会从 wallet 中 deducted,然后 article generation 开始。

Generation time
Article 和 image generation 通常需要约 2 到 3 分钟。完成后,article 会在 OxiRanker 内 visible。
Source URL
如果输入 Source URL,OxiRanker 会使用它来更好地理解 topic,但不会 generate copied content。System designed 用于创建 unique content。
步骤 12

Review Preview、SEO Report 和 JSON Output

Article generated 后,会提供多个 important outputs,用于 quality review 和 publishing preparation。

Preview

显示 article text 和 generated image。此 section 适合在 publishing 前 review final quality。

SEO Report

显示 understandable SEO report,包括 SEO Score、title、meta description、canonical、keywords、schema、headings、links、images 和 OpenGraph。

JSON Output

为 technical users 显示 full article output,包括 slug、html_body、schema、image URLs、tags、category、reading time 和 created/updated timestamps。

Outputs 的含义
这些 outputs 表明 article 不只是 plain text。它是为 WordPress、CMS、API 和 publishing systems 准备的 structured、SEO-ready content。
步骤 13

连接 WordPress 并 publish articles

在 WordPress Output tab 中,你可以将 WordPress website 连接到 OxiRanker。

Step 1: 安装 plugin

Download、install 并 activate OxiRanker plugin。

https://oxiranker.com/oxiranker.zip

WordPress 中的 installation path:

Plugins -> Add New -> Upload Plugin -> oxiranker.zip -> Activate

Step 2: 使用 Token 连接

从 Setup Wizard 复制 Domain ID 和 Connect Token,并将它们输入到 plugin settings。

DOMAIN ID:
1

CONNECT TOKEN:
wlXQy15WMB****MC1Lb08=

Connect Token 有 time limit,通常 active 30 minutes。

Step 3: Publishing method

Connection 后,选择 publishing method。

Publish
Articles 会立即 publish。
Draft
Articles 会作为 drafts 创建。
Manual
User 使用 publish button 发送 article。
Initial testing 建议
对于 initial testing,最好将 plugin 中的 default post status 设置为 Draft,这样 article 可以在 publishing 前在 WordPress 中 review。
Automatic publishing
如果 automatic publishing enabled,manual 或 automatic engine generated 的 articles 在 ready 后可以发送到 WordPress。
步骤 14

Yoast SEO 兼容性

如果你的网站使用 Yoast SEO plugin,OxiRanker 与其 compatible。

如果 Yoast installed
当 Yoast 存在时,OxiRanker 会以 Yoast 可以 use 和 render 的方式发送 SEO data。
如果 Yoast 未 installed
如果 Yoast 未 installed,OxiRanker plugin 可以自行 manage 和 render required SEO data。
步骤 15

Complete WordPress flow summary

完成这些 steps 后,你的 WordPress website 就 ready 接收 OxiRanker generated 的 articles。

在 OxiRanker 注册
添加 domain
Verify domain ownership
选择 languages 并添加 Blog URL
为每种 language 添加 keywords
完成 Article Profile
如有需要,配置 Telegram
配置 automatic article engine
从 Generate 创建第一篇 article
Review Preview 和 SEO Report
Install WordPress plugin
输入 Domain ID 和 Connect Token
选择 publishing method
在 WordPress 中 publish articles