korean-spell-check

korean-spell-check

熱門

謹慎使用 Nara/PNU 韓文拼字檢查介面校對韓文文本,將長篇輸入切分為小區塊,並返回聚焦於變更點的校正建議。

6445星標
736分支
更新於 2026/7/22
SKILL.md
唯讀
名稱
korean-spell-check
描述

謹慎使用 Nara/PNU 韓文拼字檢查介面校對韓文文本,將長篇輸入切分為小區塊,並返回聚焦於變更點的校正建議。

Korean Spell Check

What this skill does

使用反映韓國國立國語院規範的 Bareun Hangeul(前釜山大學正字法/文法檢查器) 介面來對韓文句子進行最終校對。

  • 基本進入點為公開 Web 介面 https://nara-speller.co.kr/speller/
  • 若需要自動化,僅在低請求量的前提下使用舊版表單 POST 介面 https://nara-speller.co.kr/old_speller/results
  • 長篇文本會拆分為分塊依序檢查。
  • 結果將以 原文校正案原因 為核心進行整理。

Policy first

  • https://nara-speller.co.kr/old_speller/ 明確標註了非商業用途說明,以及僅限個人或學生免費的字樣。
  • https://nara-speller.co.kr/robots.txt 允許 / 但禁止 /test_speller/
  • 因此,此 Skill 僅用於使用者主導的最終校對低頻率請求以及文件/電子郵件/README 校對用途。
  • 切勿用於批次大流量處理、SaaS 後端整合,或在商業服務中未授權轉售/再次展示。若有此類需求,應先諮詢供應商或考慮付費 API 合約。

When to use

  • 「幫我檢查這段韓文句子的拼字」
  • 「幫我對 README 的韓文句子進行最終校稿」
  • 「找出整個 Markdown 檔案中的空格/拼字錯誤」
  • 「比起 AI 校正,我想用基於規則的韓文檢查器再確認一次」

When not to use

  • 需要直接大批傳送程式碼區塊/日誌/英文為主的文本時
  • 包含大量敏感資訊的原文不適合傳送到外部 Web 服務時
  • 需要商業級大流量處理 API 時

Prerequisites

  • 網路連線
  • python3 3.10+
  • 此 Skill 目錄下的 scripts/korean_spell_check.py(安裝時會自動包含)

Verified surface notes

  • 目前公開網站提供的位址為 https://nara-speller.co.kr/speller/
  • 在此環境下,一般的 shell/Node fetch 可能會因 Cloudflare 而返回 403
  • 不過在相同環境下,採用瀏覽器型 User-Agent + Python stdlib urllib POST,可以在 old_speller/results 成功返回實際檢查結果的 HTML。
  • 免費公開介面為 HTML 結果頁面,目前未確認到有已文件化的公開 JSON API。

Workflow

1. Ask for the text or file path

  • 若直接提供文本,則立即進行檢查。
  • 若為檔案檢查,僅以 UTF-8 文本/Markdown 檔案為對象;若包含大量程式碼區塊,先詢問使用者是否要縮小檢查範圍會更安全。

2. Keep requests conservative

  • 預設分塊大小保持在 1500 字左右。
  • 分塊之間至少停頓 1 秒
  • 請勿一次執行過多檔案。

3. Run the helper

python3 scripts/korean_spell_check.py \
  --file README.md \
  --format json

較短的句子可以直接透過 --text 傳入:

python3 scripts/korean_spell_check.py \
  --text "아버지가방에들어가신다." \
  --format text

4. Return change-focused output

建議最終回覆包含以下順序:

  1. 校正後的完整句子/段落
  2. 主要變更點清單
  3. 每個變更點的 原文校正案原因
  4. 必要時附上說明:「結果基準為公開 Web 檢查器,最終語境判斷請由人工確認

範例 JSON 欄位:

{
  "original": "아버지가방에들어가신다",
  "suggestions": ["아버지가 방에 들어가신다"],
  "reason": "띄어쓰기, 붙여쓰기, 음절 대치와 같은 교정 방법에 따라 수정한 결과입니다."
}

Done when

  • 已先確認公開介面的政策。
  • 若為長篇文本已套用分塊拆分。
  • 結果已圍繞 原文/校正案/原因 進行整理。
  • 已明確非高頻率/商業用途。

Notes

  • guide: https://nara-speller.co.kr/guide/
  • main UI: https://nara-speller.co.kr/speller/
  • old UI / form post: https://nara-speller.co.kr/old_speller/, https://nara-speller.co.kr/old_speller/results
  • robots: https://nara-speller.co.kr/robots.txt