Back to Details

korean-spell-check

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Korean Spell Check

韩文拼写检查

What this skill does

技能功能

국립국어원 계열 규칙을 반영한 바른한글(구 부산대 맞춤법/문법 검사기) 표면을 이용해 한국어 문장을 최종 교정한다.
  • 기본 진입점은 공개 웹 표면 
    https://nara-speller.co.kr/speller/
    이다.
  • 자동화가 필요하면 이전 버전 폼 POST 표면 
    https://nara-speller.co.kr/old_speller/results
    를 낮은 요청량으로만 사용한다.
  • 긴 글은 청크로 나눠 순차 검사한다.
  • 결과는 
    원문
    , 
    교정안
    , 
    이유
    중심으로 정리한다.
采用反映韩国国立国语院系列规则的**正确韩文（原釜山国立大学拼写/语法检查器）**接口来对韩文句子进行最终校对。
  • 默认入口是公开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/
    는 금지한다.
  • 따라서 이 스킬은 사용자 주도 최종 검수, 저빈도 요청, 문서/이메일/README 교정 용도로만 쓴다.
  • 대량 배치, SaaS 백엔드 연동, 상업 서비스 내 무단 재판매/재노출에는 쓰지 않는다. 그런 경우는 공급사 문의/유료 API 계약을 먼저 검토한다.
  • https://nara-speller.co.kr/old_speller/
    明确标注了非商业用途提示以及仅个人或学生可免费使用的说明
  • https://nara-speller.co.kr/robots.txt
    允许爬取
    /
    路径，但禁止爬取
    /test_speller/
    路径
  • 因此本技能仅用于用户主导的最终校验、低频次请求、文档/邮件/README修正场景
  • 禁止用于批量处理、SaaS后端对接、商业服务内未经授权的二次售卖/二次展示场景。这类情况请先考虑联系服务商洽谈付费API合作

When to use

适用场景

  • "이 한국어 문장 맞춤법 검사해줘"
  • "README 한국어 문장 최종 검수해줘"
  • "마크다운 파일 전체에서 띄어쓰기/맞춤법 오류를 잡아줘"
  • "AI 교정보다 규칙 기반 한국어 검사기로 한 번 더 확인해줘"
  • "帮我检查这句韩文的拼写"
  • "帮我最终校验下README里的韩文句子"
  • "帮我找出整个Markdown文件里的空格/拼写错误"
  • "比起AI修正，帮我用基于规则的韩文检查器再核对一遍"

When not to use

不适用场景

  • 코드 블록/로그/영문 위주 텍스트를 그대로 대량 전송해야 하는 경우
  • 민감정보가 많은 원문을 외부 웹 서비스에 보내면 안 되는 경우
  • 상업적 대량 처리 API가 필요한 경우
  • 需要原样批量传输以代码块/日志/英文为主的文本的场景
  • 包含大量敏感信息的原文不适合发送到外部web服务的场景
  • 需要商业级批量处理API的场景

Prerequisites

前置要求

  • 인터넷 연결
  • python3
    3.10+
  • 이 스킬 디렉토리의 
    scripts/korean_spell_check.py
    (설치 시 자동 포함)
  • 网络连接
  • python3
    3.10及以上版本
  • 本技能目录下的
    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는 확인하지 못했다.
  • 目前公开站点地址为 
    https://nara-speller.co.kr/speller/
  • 该环境下普通shell/Node fetch请求可能会因为Cloudflare拦截返回
    403
  • 同样环境下使用浏览器类型User-Agent + Python标准库 
    urllib
    POST    请求
    old_speller/results
    可以返回实际的检查结果HTML
  • 免费公开接口返回的是HTML结果页面，暂未找到官方文档化的公开JSON API

Workflow

工作流程

1. Ask for the text or file path

1. 索要文本或文件路径

  • 텍스트가 직접 주어지면 바로 검사한다.
  • 파일 검사라면 UTF-8 텍스트/Markdown 파일만 대상으로 잡고, 코드 블록이 많으면 먼저 사용자에게 범위를 줄일지 물어보는 편이 안전하다.
  • 如果用户直接给出文本则直接检查
  • 如果是文件检查，仅支持UTF-8编码的文本/Markdown文件，如果文件包含大量代码块，建议先询问用户是否缩小检查范围更稳妥

2. Keep requests conservative

2. 保持请求节制

  • 기본 청크 크기는 
    1500
    자 안팎으로 유지한다.
  • 청크 사이는 최소 
    1초
    정도 쉬게 한다.
  • 한 번에 너무 많은 파일을 돌리지 않는다.
  • 默认分块大小保持在
    1500
    字左右
  • 块与块之间的请求间隔至少为
    1秒
  • 不要一次性处理过多文件

3. Run the helper

3. 运行辅助脚本

bash
python3 scripts/korean_spell_check.py \
  --file README.md \
  --format json
짧은 문장은 
--text
로 바로 넣을 수 있다.
bash
python3 scripts/korean_spell_check.py \
  --text "아버지가방에들어가신다." \
  --format text
bash
python3 scripts/korean_spell_check.py \
  --file README.md \
  --format json
短句子可以直接通过
--text
参数传入。
bash
python3 scripts/korean_spell_check.py \
  --text "아버지가방에들어가신다." \
  --format text

4. Return change-focused output

4. 返回以变更为核心的输出

최종 답변은 아래 순서를 권장한다.
  1. 교정된 전체 문장/문단
  2. 주요 변경점 목록
  3. 각 변경점의 
    원문
    , 
    교정안
    , 
    이유
  4. 필요하면 
    공개 웹 검사기 기준 결과이며, 최종 문맥 판단은 사람이 확인
    문구
예시 JSON 필드:
json
{
  "original": "아버지가방에들어가신다",
  "suggestions": ["아버지가 방에 들어가신다"],
  "reason": "띄어쓰기, 붙여쓰기, 음절 대치와 같은 교정 방법에 따라 수정한 결과입니다."
}
最终返回建议遵循以下顺序：
  1. 修正后的完整句子/段落
  2. 主要变更点列表
  3. 每个变更点的
    原文
    、
    修正方案
    、
    理由
  4. 如有需要可加上
    本结果基于公开web检查器生成，请人工确认最终语境是否合适
    的提示
示例JSON字段：
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
  • 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