# WordPress (self-hosted) — Content Launcher (콘텐츠 런처)

>  WordPress (self hosted) 개요 — 외부 WordPress 게시 외부 WordPress 사이트(설치형 또는 wordpress.com)에 게시합니다. 방식 : WordPress REST API ( /wp json/wp/v2/posts )로 직접 POST. 인증은 Appl

## 핵심 요약
- 외부 WordPress 사이트(설치형 또는 wordpress.com)에 콘텐츠를 게시하는 기능에 대한 안내입니다.
- WordPress REST API(/wp-json/wp/v2/posts)를 통해 직접 POST 방식으로 게시하며 인증은 Application Password를 사용합니다.
- 게시를 위해 사이트 URL, 사용자 아이디, Application Password, 기본 카테고리 ID가 필요합니다.
- Application Password는 일반 비밀번호와 달리 WordPress 관리자 프로필 페이지에서 별도로 발급받아야 합니다.
- 401, 403, 404 등 자주 발생하는 오류와 원인, 그리고 권장 운영 방식이 안내되어 있습니다.

# WordPress (self-hosted)

**개요 — 외부 WordPress 게시**

외부 WordPress 사이트(설치형 또는 wordpress.com)에 게시합니다.

**방식**: WordPress REST API (`/wp-json/wp/v2/posts`)로 직접 POST. 인증은 Application Password.

**필수 필드 — 필수 필드 안내**

* **사이트 URL**: WP 사이트 베이스. 예: `https://blog.bizspring.co.kr`.
* **사용자 아이디**: 게시 권한이 있는 WP 사용자.
* **Application Password**: 일반 비밀번호 ≠ Application Password. 별도 발급 필요.
* **기본 카테고리 ID**: WP 관리자 → 게시물 → 카테고리에서 확인.

**토큰/인증 발급 — Application Password 발급**

1. WordPress 관리자 → **사용자** → 본인 또는 게시용 계정 클릭.
2. 프로필 페이지 하단 **Application Passwords** 섹션.
3. **New Application Password Name**에 `Content Launcher` 입력.
4. **Add New Application Password** 클릭.
5. 표시된 `xxxx xxxx xxxx xxxx` 형식 비밀번호 복사 (공백 포함).
6. 위 필드에 붙여넣기.

> ⚠️ WordPress 5.6 이상에서만 지원. 일부 보안 플러그인이 이 기능을 비활성화할 수 있음. Application Passwords 섹션이 안 보이면: SSL이 활성화되지 않았거나 (https 필수), Two-Factor Auth 플러그인이 차단 중일 수 있음.

**자주 발생하는 오류 — 자주 발생하는 오류**

* **`401 Unauthorized`**: Application Password 오타 또는 사용자 아이디 불일치.
* **`403 Forbidden`**: 사용자 권한 부족. Editor 이상 권한 필요.
* **`404 No route was found`**: REST API 비활성화 또는 URL 오타. `/wp-json/wp/v2/` 확인.
* **이미지 업로드 실패**: 미디어 업로드는 별도 엔드포인트(`/wp/v2/media`) 필요.

**권장 사항 — 권장 사항**

* Editor 권한의 전용 계정을 따로 만들어 사용 (Admin 계정 직접 사용 금지).
* 기본 게시 상태는 `draft`로 두고, 검수 후 수동 publish 권장.
* 이미지는 외부 CDN URL을 본문에 삽입하면 별도 업로드 없이 표시됨.


## FAQ
**Q. Application Password는 어떻게 발급받나요?**

A. WordPress 관리자 → 사용자 → 게시용 계정 클릭 후, 프로필 페이지 하단 Application Passwords 섹션에서 이름을 'Content Launcher'로 입력하고 Add New Application Password를 클릭하면 됩니다. 표시된 비밀번호를 공백 포함해 복사해 필드에 붙여넣으면 됩니다.

**Q. Application Passwords 섹션이 안 보이는데 왜 그런가요?**

A. WordPress 5.6 이상에서만 지원되는 기능이며, SSL(https)이 활성화되지 않았거나 Two-Factor Auth 등 보안 플러그인이 이 기능을 차단하고 있을 수 있습니다.

**Q. 게시 시 401 Unauthorized 오류가 나면 어떻게 하나요?**

A. Application Password를 잘못 입력했거나 사용자 아이디가 일치하지 않을 때 발생하는 오류입니다. 입력한 정보를 다시 확인해 보세요.

**Q. 이미지 업로드가 안 되는 이유는 무엇인가요?**

A. 게시물 등록 엔드포인트와 별도로 미디어 업로드는 /wp/v2/media라는 다른 엔드포인트를 사용해야 하기 때문입니다. 대신 이미지는 외부 CDN URL을 본문에 삽입하면 별도 업로드 없이 표시할 수 있습니다.

**Q. 게시 계정은 관리자 계정을 그대로 써도 되나요?**

A. 권장하지 않습니다. Admin 계정을 직접 사용하지 말고 Editor 권한을 가진 전용 계정을 별도로 만들어 사용하는 것이 좋습니다.

---
출처: https://bizspring.ai/kb/ref/manual/content-launcher-콘텐츠-런처-wordpress-self-hosted · 최종 갱신 2026-08-28T09:47:21.071+00:00