로그인 화면, 2단계 인증 입력, 화면 조작 없이 개인 토큰 하나로 명세서 작업을 합니다. 화면을 대신 눌러 주던 외부 에이전트에게 특히 맞습니다. CLI 는 REST API를 그대로 부르므로 권한·크레딧·요청 한도가 같습니다. 처음이면 빠른 시작을 보세요.
설치
Node.js 18 이상이 필요하고 다른 의존성은 없습니다. 파일 하나를 받아 실행합니다.
curl -o inventips.mjs https://inventips.net/cli/inventips.mjs
node inventips.mjs --help
업데이트: 서버의 CLI 가 바뀌면 명령을 실행할 때 서명을 확인한 새 파일로 스스로 바꾸고 같은 명령을 다시 실행합니다. 모르는 명령을 받아도 먼저 최신본을 확인합니다. 지금 바로 바꾸려면 update, 손으로 받으려면 위 curl 을 다시 실행합니다. whoami 의 CLI: 줄에서 최신 여부를 볼 수 있습니다. 봇이 "이 기능은 웹에서만 된다" 고 판단하기 전에 최신본인지부터 확인하게 하세요. INVENTIPS_NO_AUTO_UPDATE=1 이면 바꾸지 않고 "이 CLI 는 서버의 최신본과 다릅니다" 경고만 찍고, INVENTIPS_NO_UPDATE_CHECK=1 이면 확인도 하지 않습니다.
에이전트용 사용 안내(명령 묶음·JSON 출력·종료 코드·작업 흐름)는 node inventips.mjs skill 또는 https://inventips.net/cli/SKILL.md 에 있습니다.
토큰 발급
- 웹에서 마이페이지 → 보안 → CLI 토큰으로 갑니다.
- 이름(예:
그록봇 노트북), 유효 기간(30일·90일·1년), 권한(읽기+쓰기 또는 읽기 전용)을 고르고 발급을 누릅니다. - 한 번만 보이는
itp_...토큰을 복사합니다. 다시 볼 수 없습니다.
조회·내보내기만 하는 에이전트에는 읽기 전용을 주세요. 쓰기 권한이 있으면 크레딧을 쓰는 재생성·수정 분석을 할 수 있습니다.
node inventips.mjs login --token itp_xxxxxxxx...
유효 기간: 30일·90일·1년·만료 없음(봇용) 중에서 고릅니다. 무인으로 도는 봇에는 「만료 없음」을 쓰면 로그인 때문에 멈추지 않습니다. 대신 봇마다 따로 발급하고, 조회만 하는 봇은 읽기 전용으로 두세요. 기한이 있는 토큰은 만료 14일·3일 전에 메일로 알려 주고, 14일 안으로 들어오면 CLI 가 명령마다 경고를 찍습니다(API 응답 헤더 X-Token-Expires-In-Days). whoami 에서 만료일을 볼 수 있습니다.
토큰은 ~/.inventips/config.json(권한 0600)에 저장됩니다. 환경 변수 INVENTIPS_TOKEN·INVENTIPS_BASE 가 있으면 설정 파일보다 먼저 씁니다.
명령
| 명령 | 설명 | 권한 |
|---|---|---|
login --token <t> [--base URL] | 토큰 확인 후 저장 | 읽기 |
whoami | 토큰 주인·잔여 크레딧·토큰 권한·만료일·CLI 최신 여부 | 읽기 |
drafts list [--all] [--limit N] | 명세서 목록. --all 은 OA 등 다른 문서 포함 | 읽기 |
drafts show <id> [--full] [--out f.json] | 요약(청구항·도면·검증·선행조사). --full 은 본문 전체 JSON | 읽기 |
drafts create [--text …] [--file …] [--generate] | 명세서 새로 만들기(입력 단계, 크레딧 없음). --text-file·--claims-file·--requirements·--title·--matter, 선행조사 --rounds 1|3·--no-search --prior-art-numbers·--prior-art-cutoff·--exclude-prior-art, --pages N·--provisional·--auto-finalize, 간단 모드 --direct [--direct-domain-guide]. --generate [--style] [--wait] [--yes] 면 바로 한번에 생성 | 쓰기 |
drafts create --kind divisional|continuation|priority|import (--from-draft <id> | --from-application <출원번호> | --from-file <명세서.pdf|.docx>) | 후속출원(분할·계속·우선권 주장)·명세서 가져오기 — 원본의 청구항·본문을 옮긴 새 명세서(크레딧 없음). --requirements·--title·--matter, 출원번호 원본은 --split-sections. 아래 「후속출원」 | 쓰기 |
drafts divisional-candidates <분할id> [--count N] | 분할 주제 후보 — 원출원에서 청구하지 않은 실시예·변형예와 근거 문단·인용문(원문 대조, 5 크레딧). 아래 「분할출원 청구항」 | 쓰기 |
drafts divisional-apply <분할id> (--candidate N | --requirements "…") [--generate [--wait]] | 고른 주제로 한번에 생성 준비(크레딧 없음), --generate 면 이어서 생성 | 쓰기 |
drafts divisional-show <분할id> | 분할 후보·고른 주제·분할 검사 결과 | 읽기 |
generate <draftId> --provisional | 가출원(임시 출원)용으로 생성 — 청구항 1개(넓게), 청구범위 전략·설계·검증을 끄고 실시예를 두껍게. --no-provisional 은 끄기. 청구항이 이미 있으면 --restart 와 함께(drafts create --provisional 로 처음부터 켤 수도 있다) | 쓰기 |
generate <draftId> [--restart] [--proceed | --answers "…"] [--style] [--wait] | 한번에 생성(약 25분, 단계별 크레딧). 확인 질문에서 멈추면 이어 가기. --style 은 내 작성 스타일 적용 | 쓰기 |
generate <draftId> --exclude-prior-art "번호" [--wait] | "본인 공개인가" 확인 질문에서 본인 것이면 그 문헌을 빼고 조사부터 다시(청구항이 있으면 --restart). --prior-art-cutoff YYYY-MM-DD 는 기준일 이후 출원 문헌을 뺀다 | 쓰기 |
drafts hold <id> "<사유>" / drafts release <id> | 확정 대기(수정 분석 차단) 걸기·풀기 | 쓰기 |
matter list / matter show <matterId> | 사건 목록 / 사건 카드(체크리스트·다음 할 일). 목록은 --q·--code·--app-number·--client·--state·--order(외부 주문 ID)·--limit·--offset·--all | 읽기 |
matter create --title "<사건명>" [--right …] [--state …] | 사건 만들기. --right 는 patent|trademark|design|utility|pct|overseas | 쓰기 |
matter set <matterId> [--code …] [--folder …] [--title …] [--client …] | 사건카드 고치기(--folder-ref·--right·--client-email·--applicant-code·--memo). 빈 값 "" 은 지움 | 쓰기 |
matter stage <matterId> <단계> [--note "…"] | 사건 단계 변경(한 칸씩, 시각·토큰 이름 기록) | 쓰기 |
matter filed <matterId> --application-number 10-… [--filing-date YYYY-MM-DD] [--receipt 접수번호] | 출원 접수 기록(제출은 사람이 특허로에서) | 쓰기 |
matter files <matterId> [--kind …] | 사건함 — 올린 파일과 자동 분류(서류 종류·출원번호·제출기한·제안 작업) | 읽기 |
matter add <matterId> <파일…> [--kind …] [--source email|drive|kakao|call] [--source-ref <id>] | 사건함에 파일 올리기(자동 분류). 같은 파일·같은 원본은 다시 만들지 않음. 큰 파일은 서명 URL 로(100MB 까지) | 쓰기 |
matter plan <matterId> | 사건함을 보고 할 일 제안(크레딧 없음) | 읽기 |
matter run <matterId> <단계 번호|key> [--yes] [--select 1,3] | 제안 단계 실행. 크레딧이 드는 단계는 --yes 없이 예상치만. 상표 단계는 --mark·--business | 쓰기 |
matter assign|unassign <matterId> --email … | --user … | 사무소 사건 담당자 지정·해제(대표·관리자) | 쓰기 |
matter link|unlink <matterId> --draft <id> | --search <id> | 작업(명세서·OA·우선심사·조사 기록)을 사건에 잇기·떼기 | 쓰기 |
matter export <matterId> [--out 폴더] | 사건 산출물 한 번에 받기(명세서 docx·hlz, OA 의견서·보정서, 우선심사 설명서, 조사 보고서). 크레딧 없음 | 읽기 |
matter sync <matterId> [--dir 폴더 | --root 루트] [--push | --pull] [--dry-run] | 사무소 폴더 ↔ 사건함 맞추기. 폴더는 --dir, 없으면 (--root 또는 INVENTIPS_DRIVE_ROOT) + 사건카드 폴더 | 쓰기 |
inbox classify <파일…> [--from 메일] [--client "고객"] | 사건을 모르는 파일 분류 + 맞는 사건 후보(근거·점수). 저장·크레딧 없음, 20개까지 | 읽기 |
metrics [--days 30] | 사건→출원 전환·기간, 단계 이동(봇·사람), 토큰별 작업량 | 읽기 |
notify set <https-url> / notify show|test|clear | 작업 완료·실패·확인 질문 알림 주소(HMAC 서명) | 쓰기 |
update / skill | 최신 CLI 로 바꾸기(평소엔 자동) / 에이전트용 안내 | – |
status <id> | 최근 백그라운드 작업 | 읽기 |
figures regen <draftId> <figId> [옵션] | 도면 한 장 재생성 — 10 크레딧 | 쓰기 |
figures generate <draftId> [--spec 명세서.md] [--only 1,2] [--force] [--model …] [--wait] | 도면만 일괄 생성(장당 10 크레딧, 성공한 장만). --spec 은 다른 도구가 쓴 명세서에서 도면 설명·상세한 설명·부호 칸을 찾아 넣음 | 쓰기 |
figures download <draftId> [--out 폴더] [--only 1,2] | 현재 도면 이미지를 파일로 | 읽기 |
figures history <draftId> <figId> | 도면 이력(후보)과 미리보기 URL(1시간) | 읽기 |
figures apply <draftId> <figId> <index> | 이력의 버전을 현재 도면으로(현재 도면은 이력으로 보존) | 쓰기 |
figures replace <draftId> <figId> <이미지> | 내 이미지 파일로 바로 교체(크레딧 없음, 이전 도면은 이력으로 보존) | 쓰기 |
figures add <draftId> <이미지> [--number N] [--caption "…"] [--update-refs] | 도면 칸 새로 만들기(크레딧 없음). --caption 은 【도면의 간단한 설명】에 들어감 | 쓰기 |
figures delete <draftId> <figId> [--update-refs] | 도면 칸 삭제, 뒤 번호를 당김 | 쓰기 |
figures reorder <draftId> <새 순서> [--update-refs] | 순서 변경(예: 2,1,3) | 쓰기 |
oa create --notice 통지서 --spec 출원서 [--cited 인용문헌 …] [--voluntary] | OA 사건 만들기(크레딧 없음). 대응 방향 --priority grant|scope|no-amendment, --protect, --exclude. --prior-response·--ip-type·--draft·--claims-file·--matter, 해외 OA 지시서는 --foreign US|EP|JP|CN|OTHER | 쓰기 |
oa analyze <draftId> [--feedback "…"] [--procedure reexamination|appeal] [--wait] | 거절이유 분석·대응 전략(5 크레딧). 통지서가 거절결정이면 --procedure 로 대응 절차(재심사 청구·거절결정불복심판)를 고른다. 아래 「거절결정 대응」 | 쓰기 |
oa opinion <draftId> [--strategy N] [--feedback "…"] [--procedure …] [--wait] | 고른 전략으로 의견서·보정서(자진보정은 보정안) 생성(30 크레딧). 거절결정 사건은 분석이 전제한 절차로 만든다(다르면 종료 코드 5) | 쓰기 |
oa show <draftId> / oa list | 분석·전략·의견서·보정서 본문 / 사건 목록 | 읽기 |
oa set <draftId> [--opinion-file f.md] [--amendment-file f.md] [--letter-file f.md] [--email-file f.md] | 고친 본문 저장(웹 저장과 같고 버전 기록). 준 칸만 통째로 바꿈 | 쓰기 |
oa email <draftId> [--feedback "…"] [--out 메일.txt] | 고객 안내 메일 초안(1 크레딧), 사건에 저장 | 쓰기 |
oa export <draftId> [--format docx|tracked-docx|opinion-hlz|amendment-dta|fin] | 의견서·보정서 DOCX, 변경추적본, 특허로 제출용 hlz·dta, 보정서를 붙인 FIN | 읽기 |
oa files <draftId> | OA 사건에 올린 원본 목록 | 읽기 |
oa download <draftId> <fileId> [--out 경로] | 원본 내려받기 | 읽기 |
oa summary <draftId> | 통지서 발송일·거절이유·인용문헌·분석 요약 | 읽기 |
dta --original <원본.hlz|.fin> --amended <고친.hlz> [--out f.dta] | 바뀐 청구항·식별번호만 담은 보정서(.dta). 크레딧 없음 | 읽기 |
poa create --applicant "출원인" --email 메일 [옵션] | 기본 양식으로 위임장 초안(크레딧 없음, 안 보냄). 서명 칸은 양식의 "(인)" 자리, --at x,y 로 조정. 법인은 --representative·--corp-reg-no | 쓰기 |
poa list [--status …] / poa status <poaId> | 위임장 목록 / 서명자별 서명 여부·진행 기록. 상태는 draft|sent|partially_signed|completed|cancelled | 읽기 |
poa download <poaId> [--out 경로] | PDF(서명 전 확인용, 완료 뒤 서명된 본) | 읽기 |
poa send <poaId> [--memo "…"] | 서명 링크 메일 발송(받는 사람 확인 후 y/N, 한 번만) | 쓰기 |
poa cancel <poaId> [--reason "…"] | 서명 요청 취소 | 쓰기 |
confirm request <draftId> [--email 메일 --send] [--note "…"] | 고객 출원 동의 링크(지금 버전으로 고정, 14일). 동의하면 성함·시각·접속 정보가 남고 알림 메일 | 쓰기 |
confirm list <draftId> | 동의 요청·결과 | 읽기 |
search patents "<검색식>" / search patent <번호> | KIPRIS 특허 검색 / 공보 본문(한국·해외) | 읽기 |
search trademarks "<상표명>" [--class] [--similar] / search tm-goods / search goods | 상표 검색(목록만)·칭호 유사·지정상품·고시 명칭. 보고서는 trademark report | 읽기 |
search designs "<물품명>" / search design-image <이미지> | 디자인 공보 검색 / 이미지 유사 검토(5 크레딧) | 읽기 / 쓰기 |
prior-art ["발명 설명"] [--draft <id>] [--wait [--out 보고서.pdf]] | AI 선행조사(5 크레딧, 10~20분). --out 이면 보고서 파일(pdf·docx·md)로 저장. --prior-art-cutoff·--exclude-prior-art 로 조사 범위 지정 | 쓰기 |
prior-art list | 선행조사 기록 목록(id 로 보고서·경쟁기업 조사) | 읽기 |
trademark report "<상표명>" --field "사업분야" [--class 9,35] [--scope both] [--wait [--out 보고서.docx]] | 상표 검색 보고서 — 웹 상표 검색과 같은 검색+AI 등록 가능성 분석(8 크레딧) | 쓰기 |
report <작업id|기록id> [--format md|docx|pdf] [--out 경로] [--audience client] | 상표·선행조사 보고서 받기(상표 전문가용은 md·docx). --audience client 는 고객용 1~2쪽 요약(docx·pdf) | 읽기 |
competitors sources / competitors run <기록id> | 경쟁기업 조사 입력 후보 / 보고서 만들기(AI 서술이 나오면 5 크레딧, 1~3분) | 읽기 / 쓰기 |
competitors list / competitors show <id> [--out x.docx] | 경쟁기업 조사 보고서 목록 / 본문·파일 | 읽기 |
exam-predict --claims-file <청구범위.txt> (--refs "번호,…" | --refs-file <문헌.txt>) [--summary "…"] [--spec-file f.txt] [--out 통지서.md] | 심사 예측 — 청구범위와 선행문헌(5건까지)으로 가상 의견제출통지서(15 크레딧, 1~3분, 저장 안 함). 예측이며 실제 심사 결과를 보장하지 않는다 | 쓰기 |
fto run "<제품·공정 설명>" --countries KR,US,… [--markets "…"] [--lang …] [--publications "번호,…"] [--wait] | FTO(침해 가능성) 예비 검토(15 크레딧, 수 분~30분). 침해·비침해 결론이 아니다. EP 는 --markets 필수 | 쓰기 |
fto list / fto show <id> [--full] / fto export <id> [--format docx|md] [--audience client] | FTO 조사 목록 / 후보 문헌·검토 우선순위 / 보고서 파일 | 읽기 |
fto translate <id> --lang en / fto rerun <id> | 완료된 보고서를 다른 언어로(크레딧 없음) / 실패한 조사 다시 | 쓰기 |
valuation run <한국 특허번호> [--product "…"] [--revenue-model "…"] [--prior-art <기록id>] | 특허 평가 — 권리성·기술성·활용성 등급(AI 판정이 나오면 5 크레딧, 1~수 분). 한국 특허만 | 쓰기 |
valuation sheets <id> [--business "…"] | 재무 채점표 AI 초안(5 크레딧). 값 확정·가치 계산은 웹에서 | 쓰기 |
valuation list / valuation show <id> [--full] / valuation export <id> [--audience client] | 평가 목록 / 결과 / 보고서 DOCX | 읽기 |
translate start <명세서id> (--to en|ja|zh|ko | --jurisdiction US|WO|EP|JP|CN) [--kind claims|full] [--wait] | 번역 건을 만들고 청구항 번역부터 시작(10 크레딧). 아래 「번역」 | 쓰기 |
translate run <번역id> --kind claims|full [--wait] | 그 번역 건에서 작업 시작 — 전문 번역은 20 크레딧 | 쓰기 |
translate list / translate show <번역id> [--full | --sections claims,abstract] | 번역 건 목록 / 상태·번역문 | 읽기 |
overseas deadlines <우선일 YYYY-MM-DD> [--type patent|design|trademark] | 해외 출원 기한 계산 — 파리조약 우선권, PCT 국내단계 진입(근거 포함, 휴일 순연 미반영). 크레딧 없음 | 읽기 |
docket list [--severity overdue|today|soon|normal|unknown] [--app-number …] [--limit N] | 열린 기한(마감 빠른 순)과 급한 정도별 건수 — 웹 「기한 관리」의 특허로 동기화 결과. 읽기 전용 | 읽기 |
pe reasons [--trademark] | 우선심사 사유 코드표 | 읽기 |
pe create [--trademark] --reason 코드,… [서지] [--file 출원서] [--evidence 증거 …] | 우선심사 신청 설명서 건 만들기(크레딧 없음). 서지를 비우면 출원서에서 읽어 채움 | 쓰기 |
pe generate <id> [--feedback "…"] [--wait] | 설명서 생성(10 크레딧) | 쓰기 |
pe show <id> / pe list / pe export <id> [--format docx|pdf] | 설명서 본문·증빙 체크리스트 / 목록 / 파일 | 읽기 |
export check <draftId> | hlz 제출 전 점검(파일명·xml·도면 번호·본문 참조·부호·이미지). 오류면 종료 코드 1 | 읽기 |
revise <draftId> "<지시>" [--wait] | 수정 분석 시작 — 1 크레딧(+도면 재생성 시 장당 10) | 쓰기 |
revise apply <draftId> <taskId> [--sections a,b] | 수정 제안을 명세서에 반영(기본: 전체, claims 는 청구범위) — 크레딧 없음 | 쓰기 |
task <taskId> | 작업 상태·결과 | 읽기 |
export <draftId> docx|hlz|zip [--out 경로] | 파일 내보내기(--out 이 폴더면 서버가 준 이름으로) | 읽기 |
공통 옵션은 --json(원본 JSON 출력, 오류도 {"error":…,"status":…}), --yes/-y(크레딧 확인 생략), --request-id <id>(같은 id 로 다시 실행하면 서버가 첫 결과를 돌려줌), --help/-h 입니다. 관리자용 벤치마크 명령(bench single-shot, generate --backbone)은 일반 계정에서 쓸 수 없습니다.
후속출원
웹 「후속출원에서 시작」과 같습니다. 원본은 내 명세서(--from-draft), 한국 출원번호(--from-application, KIPRIS 공보에서 청구항·설명을 가져옴), 명세서 파일(--from-file, pdf·docx) 가운데 하나입니다.
# 내 명세서에서 분할출원 — 충전 모듈만 청구하도록 지시를 붙여 처음부터 다시 쓴다
node inventips.mjs drafts create --kind divisional --from-draft 3f1c...e9 \
--requirements "원출원 청구항 5~8의 충전 모듈을 독립항으로" --generate --wait --yes
# 출원번호로 우선권 주장 출원의 바탕을 만들고, 일부만 고친다
node inventips.mjs drafts create --kind priority --from-application 10-2025-0012345
node inventips.mjs revise <새 id> "실시예 3(무선 충전)을 추가하고 청구항 9로 청구"
- 만든 명세서에는 원본의 청구항·본문이 그대로 들어 있습니다. 이어서 생성(
generate)은 이미 있는 단계를 건너뛰므로, 후속출원 지침을 넣어 다시 쓰려면generate <id> --restart(또는 만들 때--generate)를 씁니다. - 생성 프롬프트에 종류별 지침이 붙습니다. 분할은 원출원과 발명의 대상이 달라야 하고 청구범위 중복을 피하며, 계속은 같은 발명의 청구범위 보강, 우선권 주장은 우선일 뒤에 더한 실시예를 구분합니다. 원본이 내 명세서면 그 청구범위도 함께 넘겨 중복을 피합니다.
--kind import는 원본을 그대로 가져오는 것입니다(--generate를 받지 않습니다). 가져온 뒤revise·export를 씁니다.- 스캔 PDF 는 AI 가 판독합니다. 가져온 뒤 원본과 대조하세요.
- 분할출원은 아래 「분할출원 청구항」 순서(후보 보기 → 고르기 → 생성)를 권합니다.
분할출원 청구항
원출원에서 아직 청구하지 않은 실시예·변형예를 찾아 분할 청구항으로 만들고, 그 청구항이 원출원에 적힌 범위 안에 있는지 확인합니다.
node inventips.mjs drafts divisional-candidates <분할id> --yes
node inventips.mjs drafts divisional-apply <분할id> --candidate 2 --generate --wait --yes
node inventips.mjs drafts divisional-show <분할id>
- 후보 찾기는 가벼운 1회 호출(5 크레딧)입니다. 후보마다 근거 문단·인용문이 있고, 인용문은 원출원 본문과 글자대로 대조합니다(공백·문장부호·괄호 속 부호만 무시). 확인되지 않은 후보는 「근거 확인 안 됨 — 신규사항 위험」으로 표시합니다.
- 고르면 그 주제가 청구항 설계 요구사항이 되고, 원출원에서 복사한 청구항·본문을 비우며, 원출원의 선행조사 결과가 있으면 재사용합니다. 그다음은 일반 한번에 생성의 청구항 루프(선행조사 → 청구항 설계 → 회피 설계·심사 시뮬레이션 → 본문)를 그대로 타고 크레딧도 같습니다.
- 생성 루프 안에서 청구항 구성요소마다 원출원 근거를 글자대로 대조하고, 독립항이 원출원 청구항(종속항은 인용 사슬까지)과 같거나 넓으면 중복 위험으로 봅니다. 문제가 있으면 한 번 고치고, 근거 없는 종속항은 빼고, 독립항 문제가 남으면 확인 질문에서 멈춥니다(종료 코드 2,
generate <id> --proceed로 진행). 회피 설계·자동 마무리가 원출원에 없는 구성을 끌어들이면 그 수정을 버립니다.
거절결정 대응
통지서가 거절결정서이면 분석이 원문 표지로 단계를 읽습니다. oa show 에 「절차 단계」와 고를 수 있는 절차가 나옵니다.
| 절차 | --procedure | 무엇을 만드나 |
|---|---|---|
| 재심사 청구 | reexamination | 의견서 + 보정서. 보정이 필수이고 청구범위 보정은 감축·오기 정정·명확화로 제한(특허법 제47조 제3항) |
| 거절결정불복심판 청구 | appeal | 보정 없이 청구의 이유. 보정안은 만들지 않는다 |
| 분할출원 | – | 안내만 합니다. 명세서는 drafts create --kind divisional 로 |
node inventips.mjs oa analyze <id> --wait --yes # 기본: 재심사(재심사 후 거절결정이면 심판)
node inventips.mjs oa show <id> # 절차 단계·선택지·주의
node inventips.mjs oa analyze <id> --procedure appeal --wait --yes # 심판으로 바꾸면 분석부터 다시
node inventips.mjs oa opinion <id> --wait --yes
절차에 따라 보정이 필수이기도 하고 아예 못 하기도 해서, 절차를 바꾸면 분석부터 다시 해야 합니다. 분석이 전제한 절차와 다른 절차로 oa opinion 을 부르면 만들지 않고 종료 코드 5 로 끝납니다. 최후 의견제출통지도 같은 보정 제한이 걸립니다(절차 선택은 없음). 기한은 송달일 기준이라 계산해 주지 않습니다.
입력 관문과 조건 충돌
특허 OA 는 멈추지 않습니다. 부족한 입력은 실제로 읽어서 채우고, 그래도 없으면 표시한 채 진행합니다.
| 명령 | 하는 일 |
|---|---|
oa notice <id> | 입력 확인 — 통지서 본문이 충분한지, 통지서의 인용발명 번호와 올린 인용문헌의 대응. 크레딧 없음 |
oa notice <id> --read → --confirm [--text-file f.txt] | 선택 — 스캔 통지서를 판독해 사람이 원본과 대조·확정(하지 않으면 분석이 AI 판독본으로 진행) |
oa notice <id> --text-file 본문.txt · oa create … --notice-text-file 본문.txt | 선택 — 통지서 본문 글자를 사람이 직접 넣는다 |
oa create … --notice-kind rejection-decision · oa analyze <id> --notice-kind … | 받은 서류의 종류(first-notice·final-notice·rejection-decision·reexam-rejection-decision). 본문에서 읽은 단계보다 우선하고, 다르면 oa show 에 경고 |
oa analyze <id> | 통지서 글자 층이 부실하면 스캔 쪽을 AI 판독해 진행(「AI 판독본 사용」·품질 경고·「원문 판독 실패」), 빠진 인용문헌은 자동 확보를 시도하고 못 얻으면 「본문 미확보」 |
oa opinion <id> [--conflict relax|argue] | 계획 → 작성 → 해소 검증, 미해소면 계획을 고쳐 다시(기본 2번). 조건과 충돌하면 조건 완화안·유지안을 모두 만들어 비교. --conflict 는 한 안만 원할 때 |
oa choose <id> relax|argue | 두 대안 가운데 하나를 본문으로 고른다(크레딧 없음) |
oa show 는 AI 판독 여부, 인용문헌 대응·자동 확보, 거절이유별 계획과 판정, 남은 거절이유의 사유·시도한 수·다음 조치, 두 대안 비교를 보여 줍니다. 계획·검증·되돌림·두 안 생성은 같은 30 크레딧입니다.
번역
내 명세서를 원문으로 하는 번역만 다룹니다(문서 파일로 시작하는 번역·검토·내보내기는 웹).
node inventips.mjs translate start 3f1c...e9 --to en --wait --yes # 청구항 번역(10 크레딧)
node inventips.mjs translate run <번역id> --kind full --wait --yes # 전문 번역(20 크레딧)
node inventips.mjs translate show <번역id> --full --out 번역.json
- 전문 번역은 청구항을 다시 옮기지 않고, 번역된 청구항의 용어를 기준으로 나머지 섹션을 옮깁니다. 그래서 청구항 번역이 먼저입니다.
- 크레딧은 작업이 번역을 시작할 때 차감되고 실패해도 돌려주지 않습니다. 같은 번역 건에
run을 두 번 보내지 마세요. - 일부 섹션이 실패하면 그 섹션에
[번역 실패 — 재시도해주세요]가 들어갑니다.translate show가 알려 줍니다. - 관할이 번역 언어를 정합니다(US·WO·EP 영어, JP 일본어, CN 중국어).
--to만 주면 대표 관할을 고릅니다.
figures regen 옵션
--instruction "..."바꿀 내용--ref img.png참조 이미지(PNG·JPEG·WEBP, 10MB 이하)--role 3d|dimension|sketch참조 이미지 종류(3D 그림·치수 도면·손그림)--mode new|existing|sketch그리는 방식. 기본은 참조가 있으면sketch, 현재 도면이 있으면existing, 없으면new--apply결과를 바로 현재 도면으로(이전 도면은 이력). 없으면 후보로만 저장
종료 코드
봇이 메시지를 해석하지 않고도 갈래를 탈 수 있게 종료 코드를 나눕니다.
| 코드 | 뜻 |
|---|---|
| 0 | 성공 |
| 1 | 오류(입력·서버 오류, export check 점검 실패, 실패한 작업) |
| 2 | 한번에 생성이 확인 질문에서 멈춤(--proceed 또는 --answers 로 이어 가기) |
| 3 | 인증·권한(HTTP 401·403) |
| 4 | 크레딧 부족(HTTP 402) |
| 5 | 진행 중인 작업과 겹침(HTTP 409) |
예시
# 명세서 찾기
node inventips.mjs drafts list
# 도 2 의 부호만 고친 후보 → 확인 → 적용
node inventips.mjs figures regen 3f1c...e9 2 --instruction "부호 220 과 230 을 바꿔 표기"
node inventips.mjs figures history 3f1c...e9 2
node inventips.mjs figures apply 3f1c...e9 2 0
# 직접 그린 도면 파일로 도 2 를 교체(--ref 와 달리 AI 가 다시 그리지 않는다)
node inventips.mjs figures replace 3f1c...e9 2 ./fig2.png
# 3D 그림을 참고해 도 1 을 다시 그리고 바로 교체
node inventips.mjs figures regen 3f1c...e9 1 --ref render.png --role 3d --apply --yes
# 수정 지시 후 결과 기다리기
node inventips.mjs revise 3f1c...e9 "청구항 1항의 '고정부'를 '체결부'로 통일" --wait
# 결과에 나온 taskId 로 반영(일부만 하려면 --sections detailedDescription,claims)
node inventips.mjs revise apply 3f1c...e9 7b2d...41
# 내보내기
node inventips.mjs export 3f1c...e9 hlz --out ./출원.hlz
# 봇에서 — 발명 설명으로 명세서를 만들고 끝까지 생성, 종료 코드로 갈래 타기
node inventips.mjs drafts create --text-file invention.txt --title "드론 배터리 교체 장치" \
--generate --wait --yes --json --request-id draft-2026-11-12-001 > result.json
case $? in
0) echo "완료" ;;
2) echo "확인 질문 — drafts show 의 pendingQuestions 를 사람에게 묻기" ;;
4) echo "크레딧 부족" ;;
*) echo "실패" ;;
esac
알아둘 것
- 토큰은 비밀번호와 같습니다. 저장소·채팅·로그에 붙여 넣지 마세요. 노출됐으면 마이페이지에서 바로 폐기하고 새로 발급합니다.
- 크레딧을 쓰는 명령은 예상 크레딧을 먼저 보여 주고 확인을 묻습니다. 비대화형 실행에서는
--yes가 없으면 실행하지 않습니다. - 쓰기 요청에는 CLI 가
Idempotency-Key를 자동으로 붙입니다. 연결이 끊기거나 502·503·504 가 오면 같은 키로 1초·3초·9초 뒤 다시 보내므로 두 번 실행되지 않습니다. 프로세스를 다시 띄워도 같은 키를 쓰려면--request-id를 주세요. revise결과는 제안입니다.revise apply로 반영하거나 웹 최종 검토 화면에서 고릅니다. 반영 전 값은 수정 이력에 남아 웹에서 되돌릴 수 있고, 같은 제안은 두 번 반영되지 않습니다. 웹에서 같은 명세서를 열어 둔 상태라면 반영 뒤 새로고침하세요 — 열린 화면이 자동 저장하면 반영 내용을 덮을 수 있습니다. 도면 제안은 이력에 후보로 들어갑니다.- 요청 제한과 권한 규칙은 연동 개요를 보세요.
문제 해결
| 증상 | 원인과 해결 |
|---|---|
토큰이 없습니다. 먼저 inventips login … | login --token 을 하지 않았고 INVENTIPS_TOKEN 도 없습니다. |
401 토큰이 유효하지 않습니다 (종료 코드 3) | 만료·폐기됐습니다. whoami 로 만료일을 보고, 마이페이지에서 새로 발급해 login 합니다. |
403 … 'write' 권한이 없습니다 (종료 코드 3) | 읽기 전용 토큰입니다. 읽기+쓰기 토큰으로 바꿉니다. |
403 커넥터 토큰은 MCP 도구에서만… | AI 커넥터가 만든 토큰을 넣었습니다. CLI 토큰을 따로 발급하세요. |
확인 입력을 받을 수 없습니다(비대화형) | 봇·스크립트에서 크레딧 명령을 돌렸습니다. 예상치를 확인한 뒤 --yes 를 붙입니다. |
429 … (N초 뒤 다시 시도) | 요청 한도입니다. 표시된 초만큼 기다립니다. --wait 대신 notify set 으로 완료 알림을 받으면 폴링이 줄어듭니다. |
| 새 명령이 없다고 나옴 | 옛 CLI 입니다. update 를 실행하거나 curl 로 다시 받습니다. 자동 업데이트를 끈 환경(INVENTIPS_NO_AUTO_UPDATE·INVENTIPS_NO_UPDATE_CHECK)인지 확인하세요. |
서버에 연결하지 못했습니다 | 네트워크·프록시 문제입니다. 사내망이면 https://inventips.net 으로 나가는 HTTPS 를 허용해야 합니다. |
| 종료 코드 2 | 한번에 생성이 핵심 확인 질문에서 멈췄습니다. drafts show <id> 의 pendingQuestions 에 답해 generate <id> --answers "…", 그대로면 --proceed. |
| 종료 코드 5 | 같은 문서에서 작업이 도는 중이거나 확정 대기가 걸려 있습니다. status <id> 로 확인하고, 확정 대기는 drafts release <id>. |