OXIRANKER DEVELOPER DOCS

OxiRanker 문서

웹사이트를 OxiRanker 서비스에 연결하기 위한 깔끔한 문서 센터입니다. WordPress 연동 또는 API 연동으로 시작한 뒤, 가이드를 step by step으로 따라가세요.

공식 문서Full-feature V1사이트 소유자, 개발자 및 연동 팀을 위한 문서
문서 메뉴
메뉴에서 가이드를 선택하세요. 이 페이지는 OxiRanker의 메인 문서 센터입니다.
WordPress 서비스

WordPress 서비스

웹사이트를 OxiRanker WordPress 플러그인에 연결하고 생성된 글을 받아 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에 저장해야 하며 public display를 위해 OxiRanker URLs에 의존해서는 안 됩니다.

교육 영상

연결 교육 영상

WordPress를 연결하거나 API 연동을 구현하기 전에 이 영상을 시각적 walkthrough로 사용하세요.

OxiRanker WordPress 플러그인 다운로드

WordPress 플러그인 파일을 다운로드하고 WordPress dashboard의 Upload Plugin 섹션에서 설치하세요.

플러그인 파일
oxiranker.zip
플러그인 다운로드

플러그인을 다운로드하고 WordPress에 upload한 뒤 활성화한 다음, Domain ID와 Connect Token으로 연결하세요.

STEP 01

OxiRanker에 가입하고 domain 만들기

먼저 OxiRanker에 가입하고 account에 sign in한 다음 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으로 이동합니다.
STEP 02

domain 소유권 확인

이 step에서는 domain이 본인 소유이거나 관리 access가 있음을 증명해야 합니다.

DNS TXT

권장

domain DNS에 TXT record를 추가하세요. Cloudflare의 경우 일반적으로 가장 간단한 방법입니다.

DNS Name:
_yourdomain-verification.example.com

TXT Value:
acb1****29803

HTTP File

OxiRanker가 확인할 수 있도록 웹사이트의 .well-known path에 text file을 배치하세요.

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 note
DNS record를 추가한 뒤, 특히 Cloudflare에서는 2~3분 기다려야 할 수 있습니다. 그런 다음 같은 OxiRanker page에서 Confirm을 클릭하세요.
Verification token lifetime
Domain verification values에는 time limit이 있습니다. 현재 verification values는 일반적으로 1440 minutes 동안 valid입니다.
STEP 03

첫 domain 확인 후 무료 token 받기

첫 domain을 verify한 후 OxiRanker는 initial testing을 위해 account에 1000 free tokens를 추가합니다.

첫 domain에만 적용
이 gift는 첫 번째 verified domain에만 추가되며 이후 domains에는 다시 추가되지 않습니다.
STEP 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여야 한다는 것입니다.
STEP 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와 일치해야 합니다.
STEP 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는 별도로 저장할 수 있습니다.

Tone

formal, educational, simple, technical 또는 sales-oriented 등 generated content의 style과 voice를 제어합니다.

Content goal

articles가 달성해야 할 목표를 정의합니다. 예: customers 유치, traffic 증가, users 교육.

금지된 주제

brand가 이야기해서는 안 되거나 연관되어서는 안 되는 모든 항목을 여기에 입력합니다.

Optional CTA

CTA는 article을 읽은 후 reader가 취하기를 원하는 action을 의미합니다. 어떤 text가 suitable한지 확실하지 않다면 이 field를 empty로 두는 것이 좋습니다.

Multilingual profile
웹사이트가 multilingual인 경우 profile은 하나의 language로만 완료하면 됩니다. OxiRanker는 동일한 profile을 기반으로 다른 languages에 필요한 versions를 준비할 수 있습니다.
STEP 07

내부 및 외부 링크

OxiRanker는 articles 안에 internal links와 external links를 intelligent하게 적용할 수 있습니다.

Internal links

이 option은 default로 enabled되어 있으며 enabled 상태를 유지하는 것이 좋습니다. Internal linking은 search engines가 웹사이트의 content structure를 더 잘 이해하도록 돕습니다.

첫 번째 article에서는 previous article이 아직 없기 때문에 internal links가 일반적으로 생성되지 않습니다. 두 번째 article부터 system은 internal linking을 수행할 수 있습니다.

External links

External links는 official 및 trusted sources에 추가되며 SEO authority가 의도치 않게 전달되지 않도록 nofollow로 marked됩니다.

STEP 08

AI로 profile quality 확인

Article Profile을 완료한 후 OxiRanker는 profile quality를 review합니다.

85+
저장에 필요한 minimum score
95
개선 후 일반적으로 도달하는 excellent score
AI
각 field에 대한 professional suggestions
score가 85 미만인 경우
system은 final saving을 허용하지 않으며 각 problematic field에 대한 explanations와 improvement suggestions를 표시합니다. suggestions를 적용한 뒤 다시 save할 수 있습니다.
STEP 09

article summaries를 위해 Telegram 연결

profile을 성공적으로 save한 후 Telegram channel로 article summaries 전송을 enable할 수 있습니다.

1

bot 추가

@Oxiranker_Bot을 Telegram channel에 추가하고 Admin으로 설정하세요.

2

channel username 입력

channel name을 @와 함께 입력하세요. 예: @my_channel

3

summary delivery enable

valid channel을 등록한 후 article summary delivery를 enable하세요.

Telegram benefit
enabled 상태이면 content generation 후 article summary가 image와 link와 함께 Telegram channel로 전송됩니다. 이는 웹사이트로 향하는 traffic paths를 강화할 수 있습니다.
STEP 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는 약 2~3일마다를 의미합니다. 7 articles는 약 3~4일마다를 의미합니다.

Article length 및 image

Article length는 Short, Standard 또는 Long일 수 있습니다. Standard는 대부분의 웹사이트에 balanced choice입니다.

Article images는 enabled 또는 disabled로 설정할 수 있으며 image theme은 Light 또는 Dark로 선택할 수 있습니다.

STEP 11

Generate에서 첫 번째 article 만들기

domain을 준비한 뒤 Generate menu를 열고 domain을 선택한 다음 New Content 또는 New Article을 클릭하세요.

1

Language

각 content request에는 하나의 language만 선택됩니다.

2

Topic

명확한 topic을 작성하세요. Source URL은 optional입니다.

3

Image

image를 enable 또는 disable하고 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을 더 잘 이해하기 위해 이를 사용하지만 copied content를 generate하지 않습니다. system은 unique content를 만들도록 설계되었습니다.
STEP 12

Preview, SEO Report 및 JSON Output 검토

article이 generated된 후 quality review 및 publishing preparation을 위한 여러 important outputs를 사용할 수 있습니다.

Preview

article text와 generated image를 표시합니다. 이 section은 publishing 전 final quality를 review하는 데 유용합니다.

SEO Report

SEO Score, title, meta description, canonical, keywords, schema, headings, links, images 및 OpenGraph를 포함한 understandable SEO report를 표시합니다.

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입니다.
STEP 13

WordPress 연결 및 articles publish

WordPress Output tab에서 WordPress website를 OxiRanker에 연결할 수 있습니다.

Step 1: 플러그인 설치

OxiRanker plugin을 download, install 및 activate하세요.

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을 copy하고 plugin settings에 입력하세요.

DOMAIN ID:
1

CONNECT TOKEN:
wlXQy15WMB****MC1Lb08=

Connect Token에는 time limit이 있으며 일반적으로 30 minutes 동안 active입니다.

Step 3: Publishing method

연결 후 publishing method를 선택하세요.

Publish
Articles가 즉시 publish됩니다.
Draft
Articles가 drafts로 생성됩니다.
Manual
user가 publish button을 사용하여 article을 보냅니다.
initial testing 권장 사항
initial testing에서는 article이 publish되기 전에 WordPress에서 review될 수 있도록 plugin의 default post status를 Draft로 설정하는 것이 좋습니다.
Automatic publishing
automatic publishing이 enabled된 경우 manual 또는 automatic engine으로 generated된 articles는 ready된 후 WordPress로 보낼 수 있습니다.
STEP 14

Yoast SEO 호환성

웹사이트가 Yoast SEO plugin을 사용하는 경우 OxiRanker는 해당 plugin과 compatible합니다.

Yoast가 installed된 경우
OxiRanker는 Yoast가 있을 때 Yoast가 사용하고 render할 수 있는 방식으로 SEO data를 전송합니다.
Yoast가 installed되어 있지 않은 경우
Yoast가 installed되어 있지 않으면 OxiRanker plugin이 required SEO data를 직접 manage하고 render할 수 있습니다.
STEP 15

Complete WordPress flow summary

이 steps를 완료하면 WordPress website는 OxiRanker에서 generated된 articles를 받을 준비가 됩니다.

OxiRanker에 가입하기
domain 추가하기
domain ownership verify하기
languages 선택 및 Blog URL 추가
각 language에 keywords 추가
Article Profile 완료
필요한 경우 Telegram 설정
automatic article engine 설정
Generate에서 첫 article 만들기
Preview 및 SEO Report review
WordPress plugin install
Domain ID 및 Connect Token 입력
publishing method 선택
WordPress에서 articles publish