스킬 scanlume-ocr-api
📦

scanlume-ocr-api

콘텐츠 리비전 r1 높은 위험 🌐 네트워크 접근🔑 환경 변수⚙️ 외부 명령어

Scanlume OCR로 텍스트 추출

팀은 스크린샷, 영수증, 이미지 기반 표에 대해 신뢰할 수 있는 OCR이 필요한 경우가 많습니다. 이 skill은 Claude, Codex, Claude Code가 Scanlume API 호출과 구조화된 OCR 출력을 처리하도록 안내합니다.

지원: Claude Codex Code(CC)
Maintain this Skill? Claim it ⚠️ 38 나쁨

내 에이전트로 설치

이 요청을 에이전트에 복사하세요. 공식 Skill 페이지와 매니페스트가 포함되어 있습니다.

에이전트 요청
Review the Skillstore skill "scanlume-ocr-api" from https://skillstore.io/skills/daanaagua-scanlume-ocr-api.md and its manifest at https://skillstore.io/api/skills/daanaagua-scanlume-ocr-api/manifest. Verify the artifact. Stop and obtain explicit user consent before installing or changing files.

에이전트는 계속해서 계획을 표시하고 보안 정책에서 요구하는 확인을 요청해야 합니다.

에이전트가 읽기 쉬운 리소스

AI 에이전트, 크롤러, 스크립트가 전체 페이지 대신 정리된 컨텍스트만 필요할 때 이 링크를 사용하세요.

Markdown 상세 GET /skills/daanaagua-scanlume-ocr-api.md 서명된 manifest GET /api/skills/daanaagua-scanlume-ocr-api/manifest 서명된 lockfile GET /api/skills/daanaagua-scanlume-ocr-api/lockfile

테스트해 보기

"scanlume-ocr-api" 사용 중입니다. 품목명, 가격, 합계가 포함된 영수증 스크린샷.

예상 결과:

품목, 소계, 세금, 총액, 불명확한 필드를 명시한 깔끔한 텍스트 추출 결과.

"scanlume-ocr-api" 사용 중입니다. 그룹화된 행이 있는 작은 판매 표 이미지.

예상 결과:

열, 행 그룹, 레코드 수, formatted OCR 응답의 참고 사항이 포함된 구조화된 표 요약.

"scanlume-ocr-api" 사용 중입니다. 제목과 문단이 포함된 제품 설정 스크린샷.

예상 결과:

제목, 문단, 읽기 순서를 보존하는 Markdown-ready 문서.

보안 감사

높은 위험
v4 • 2026. 7. 5. 버전별 보고서 열기

Review found a legitimate OCR integration that sends local image data to the Scanlume API and handles a bearer API key. Most Markdown backtick findings are false positives, but the helper has real network, secret-handling, and command-execution risk. The main added concern is that an overridden base URL can receive the Authorization header.

5
스캔된 파일
667
분석된 줄 수
23
검토 항목
0
오탐 무시됨

확인된 보안 우려 사항 (2)

높음
scripts/scanlume_ocr.py:20-21scripts/scanlume_ocr.py:70-78scripts/scanlume_ocr.py:152-174
API Key Exposure Through Base URL Override
The helper accepts an explicit or environment-provided base URL and sends Authorization bearer credentials to that computed endpoint. A malicious invocation could redirect the Scanlume API key to an untrusted server.
The code directly combines base URL override support with bearer-token request construction, which is a clear credential redirection risk.
중간
SKILL.md:20scripts/scanlume_ocr.py:57-60scripts/scanlume_ocr.py:172-174
Local Image Content Uploaded To External OCR Service
The helper reads a local file, encodes it as a data URL, and posts it to the Scanlume OCR API. Sensitive screenshots or documents may be disclosed if user consent and data handling are unclear.
The helper reads local bytes, builds a base64 data URL, and submits the payload through the API request path.
기능 검토 항목 (23)

이 스킬에 대해 예상될 수 있는 실제 로컬 기능이므로 검토가 필요하지만, 확인된 악의적 동작으로는 집계되지 않습니다.

높음
scripts/scanlume_ocr.py:26
Generic API/secret keys
value = explicit or os.environ.get("SCANLUME_API_KEY")
The helper reads a Scanlume API key from the environment. This is legitimate for authentication, but it is real secret access.
높음
scripts/scanlume_ocr.py:70
Generic API/secret keys
def perform_request(base_url: str, api_key: str, payload: dict[str, str], timeout: int) -> dict[str,
The request helper accepts an api_key parameter that is later used for authentication. This is expected, but it is part of the credential transmission path.
높음
scripts/scanlume_ocr.py:77
Generic API/secret keys
"Authorization": f"Bearer {api_key}",
The Authorization header is built from the API key and sent with the request. If the endpoint is overridden, the credential can be exposed.
높음
scripts/scanlume_ocr.py:152
Generic API/secret keys
parser.add_argument("--api-key", help="Override SCANLUME_API_KEY.")
The CLI accepts an API key argument. Command-line secrets can leak through shell history, logs, or process listings.
높음
scripts/scanlume_ocr.py:167
Generic API/secret keys
api_key = require_api_key(args.api_key)
The main flow loads the API key before making the OCR request. This is legitimate, but it confirms runtime secret handling.
높음
scripts/scanlume_ocr.py:174
Generic API/secret keys
response_json = perform_request(base_url, api_key, payload, args.timeout)
The loaded API key is passed into the outbound request. This is expected for Scanlume auth, but it is credential transmission over the network.
중간
SKILL.md:20
Ruby/shell backtick execution
5. If the user gives a local file path, prefer `scripts/scanlume_ocr.py` to build the data URL and c
The workflow tells the agent to prefer the local Python helper when given a local file path. This can read local files and submit their contents to an external API.
중간
SKILL.md:52
Ruby/shell backtick execution
- Use `python scripts/scanlume_ocr.py <path> --mode formatted --output md` for a local table image.
The helper command example runs a Python script on a user-provided path. This is intended, but it is real external command execution.
중간
SKILL.md:53
Ruby/shell backtick execution
- Use `python scripts/scanlume_ocr.py <path> --mode simple --output txt` for plain text extraction.
The helper command example runs a Python script on a user-provided path. This is intended, but it is real external command execution.
중간
SKILL.md:71
Ruby/shell backtick execution
5. Se o usuario fornecer um caminho local, prefira `scripts/scanlume_ocr.py` para gerar a data URL e
The Portuguese workflow tells the agent to prefer the local Python helper for user-provided paths. This can read local files and call the API.
중간
SKILL.md:103
Ruby/shell backtick execution
- Use `python scripts/scanlume_ocr.py <path> --mode formatted --output md` para uma imagem local com
The Portuguese helper example runs the local Python script for formatted OCR. This is real external command execution.
중간
SKILL.md:104
Ruby/shell backtick execution
- Use `python scripts/scanlume_ocr.py <path> --mode simple --output txt` para extracao simples de te
The Portuguese helper example runs the local Python script for simple OCR. This is real external command execution.
낮음
agents/openai.yaml:3
Hardcoded URL
short_description: "Image OCR / OCR de imagem for https://www.scanlume.com/."
The agent metadata names the external Scanlume service. This is expected for the skill, but it signals third-party OCR processing.
낮음
agents/openai.yaml:4
Hardcoded URL
default_prompt: "Use $scanlume-ocr-api to call https://www.scanlume.com/ for image OCR and return th
The default prompt directs the agent to call Scanlume for OCR. User image data can leave the local environment during normal use.
낮음
scripts/scanlume_ocr.py:70
HTTP client library
def perform_request(base_url: str, api_key: str, payload: dict[str, str], timeout: int) -> dict[str,
The helper defines an outbound HTTP request function for the OCR endpoint. This is intended behavior, but it creates external data transfer risk.
낮음
scripts/scanlume_ocr.py:174
HTTP client library
response_json = perform_request(base_url, api_key, payload, args.timeout)
The helper invokes the outbound request after building the OCR payload. Local image content is submitted to a network API.
낮음
scripts/scanlume_ocr.py:13
Hardcoded URL
DEFAULT_BASE_URL = "https://api.scanlume.com"
The script hardcodes the default Scanlume API host. This is an expected external dependency, but it confirms network egress.
낮음
scripts/scanlume_ocr.py:153
Hardcoded URL
parser.add_argument("--base-url", help="Override SCANLUME_BASE_URL. Default / Padrao: https://api.sc
The argument help documents a base URL override that controls the outbound endpoint. Misuse can redirect OCR payloads away from the official API.
낮음
scripts/scanlume_ocr.py:21
Python environment access
value = explicit or os.environ.get("SCANLUME_BASE_URL") or DEFAULT_BASE_URL
The script reads SCANLUME_BASE_URL from the environment to decide the outbound endpoint. That configuration can affect where data is sent.
낮음
scripts/scanlume_ocr.py:26
Python environment access
value = explicit or os.environ.get("SCANLUME_API_KEY")
The script reads SCANLUME_API_KEY from the environment. This is expected API authentication, but it handles a sensitive credential.
낮음
SKILL.md:3
Hardcoded URL
description: Use when calling the Scanlume OCR API for screenshots, JPG, PNG, or image-based tables,
The skill description identifies Scanlume as the external OCR provider. Normal use can send user images to that third party.
낮음
SKILL.md:8
Hardcoded URL
Use this skill when the task is specifically about calling the public OCR API behind [https://www.sc
The instructions say the skill is for calling the public Scanlume OCR API. This confirms intended external network use.
낮음
SKILL.md:10
Hardcoded URL
Use este skill quando a tarefa for especificamente chamar a API publica de OCR do [https://www.scanl
The Portuguese instructions also direct use of the public Scanlume OCR API. This confirms intended external network use.

위험 요인

🌐 네트워크 접근 (12)
agents/openai.yaml:3 agents/openai.yaml:4 scripts/scanlume_ocr.py:70 scripts/scanlume_ocr.py:174 scripts/scanlume_ocr.py:13 scripts/scanlume_ocr.py:51 scripts/scanlume_ocr.py:52 scripts/scanlume_ocr.py:153 SKILL.md:3 SKILL.md:8 SKILL.md:10 SKILL.md:109
🔑 환경 변수 (15)
references/api-contract.md:17 references/api-contract.md:97 scripts/scanlume_ocr.py:21 scripts/scanlume_ocr.py:26 scripts/scanlume_ocr.py:25 scripts/scanlume_ocr.py:26 scripts/scanlume_ocr.py:29 scripts/scanlume_ocr.py:30 scripts/scanlume_ocr.py:70 scripts/scanlume_ocr.py:77 scripts/scanlume_ocr.py:152 scripts/scanlume_ocr.py:167 scripts/scanlume_ocr.py:174 SKILL.md:27 SKILL.md:78
⚙️ 외부 명령어 (38)
SKILL.md:17 SKILL.md:18 SKILL.md:19 SKILL.md:20 SKILL.md:21 SKILL.md:26 SKILL.md:27 SKILL.md:28 SKILL.md:29 SKILL.md:30 SKILL.md:37 SKILL.md:42 SKILL.md:46 SKILL.md:50 SKILL.md:51 SKILL.md:52 SKILL.md:53 SKILL.md:59 SKILL.md:60 SKILL.md:68 SKILL.md:69 SKILL.md:70 SKILL.md:71 SKILL.md:72 SKILL.md:77 SKILL.md:78 SKILL.md:79 SKILL.md:80 SKILL.md:81 SKILL.md:88 SKILL.md:93 SKILL.md:97 SKILL.md:101 SKILL.md:102 SKILL.md:103 SKILL.md:104 SKILL.md:110 SKILL.md:111
감사자: codex 감사 이력 보기 →
이 보고서 공유 및 인용

버전이 지정된 평가 보고서, 중립 배지, 임베드 카드 및 인용을 공유하세요. Skillstore는 근거를 보고하지만 이 Skill의 안전 여부를 판단하지 않습니다.

버전별 보고서 열기
보안 평가

보고서 링크 복사

https://skillstore.io/skills/daanaagua-scanlume-ocr-api/audits/4?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Markdown 배지

[![Skillstore security assessment](https://skillstore.io/badges/skills/daanaagua-scanlume-ocr-api/security.svg)](https://skillstore.io/skills/daanaagua-scanlume-ocr-api?utm_source=security_passport_badge)

HTML 배지

<a href="https://skillstore.io/skills/daanaagua-scanlume-ocr-api?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/daanaagua-scanlume-ocr-api/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

임베드 카드

<iframe src="https://skillstore.io/embed/skills/daanaagua-scanlume-ocr-api.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>
학술 인용 (APA · BibTeX · CFF)

APA 인용

daanaagua. (2026). scanlume-ocr-api security audit report (audit version 4) [Author version unspecified]. Skillstore. https://skillstore.io/skills/daanaagua-scanlume-ocr-api/audits/4

BibTeX 인용

@techreport{daanaagua-daanaagua-scanlume-ocr-api-2026, author = {daanaagua}, title = {scanlume-ocr-api security audit report (audit version 4)}, institution = {Skillstore}, year = {2026}, number = {4}, url = {https://skillstore.io/skills/daanaagua-scanlume-ocr-api/audits/4}, note = {Author version unspecified} }

CITATION.cff

cff-version: 1.2.0 message: "If you use this Skill, cite its author and this versioned security audit report." title: "scanlume-ocr-api security audit report (audit version 4)" version: "unspecified" type: report authors: - name: "daanaagua" date-released: "2026-07-05" url: "https://skillstore.io/skills/daanaagua-scanlume-ocr-api/audits/4" identifiers: - type: other value: "skillstore:daanaagua-scanlume-ocr-api:audit:4" description: "Skillstore immutable audit report identifier"

Skillstore 점수

이 점수의 이유 증거 신뢰도: 중간
64
아키텍처
85
유지보수성
87
콘텐츠
69
커뮤니티
83
사양 준수

만들 수 있는 것

스크린샷을 텍스트로 변환

노트, 지원 티켓 또는 QA 기록을 위해 인터페이스 스크린샷에서 일반 텍스트를 추출합니다.

이미지에서 표 복원

formatted OCR을 사용하여 영수증, 보고서 또는 캡처된 스프레드시트의 표 구조를 보존합니다.

OCR API 호출 자동화

data URL을 준비하고, Scanlume 엔드포인트를 호출하며, 후속 작업에 가장 적합한 응답 필드를 반환합니다.

이 프롬프트를 사용해 보세요

일반 텍스트 추출 
이 로컬 이미지에 Scanlume OCR을 사용하고 추출된 일반 텍스트만 반환하세요. 구조가 필요하지 않으면 simple mode를 사용하세요.
표 구조 보존 
이 표 이미지에 formatted Scanlume OCR을 사용하세요. 깔끔한 표 요약을 반환하고 불확실한 셀을 표시하세요.
최적의 출력 선택 
이미지 목표를 검사하고 simple 또는 formatted OCR을 선택한 뒤, 최종 출력을 반환하기 전에 선택한 모드를 설명하세요.
OCR 워크플로 구축 
스크린샷 폴더에 대해 반복 가능한 Scanlume OCR 워크플로를 만드세요. 모드 선택, 출력 필드 선택, 오류 처리 지침을 포함하세요.

모범 사례

  • 레이아웃, 제목 또는 표가 중요할 때는 formatted mode를 사용하세요.
  • API key를 프롬프트에 직접 전달하는 대신 환경 기반 secrets를 사용하세요.
  • 민감한 이미지를 외부 OCR API로 보내기 전에 사용자 동의를 확인하세요.

피하기

  • 이 helper에 대해 공개 PDF OCR API 지원을 주장하지 마세요.
  • 사용자가 외부 처리를 수락하지 않는 한 비공개 스크린샷을 보내지 마세요.
  • 엔드포인트를 신뢰할 수 없는 경우 API base URL을 재정의하지 마세요.

자주 묻는 질문

이 skill은 어떤 이미지 유형을 대상으로 하나요?
로컬 스크린샷, JPG 파일, PNG 파일 및 추론된 MIME type이 있는 기타 이미지 파일을 대상으로 합니다.
PDF OCR을 지원하나요?
아니요. 공개 Scanlume PDF API가 일반적으로 제공되지 않으므로 helper가 PDF를 차단합니다.
어떤 도구가 이 skill을 사용할 수 있나요?
생성된 metadata는 Claude, Codex, Claude Code를 지원 도구로 나열합니다.
simple mode와 formatted mode의 차이는 무엇인가요?
simple mode는 원시 텍스트를 반환합니다. formatted mode는 구조, Markdown, HTML, 블록, 표 요약 필드를 보존합니다.
이 skill에 API key가 필요한가요?
예. helper는 환경 또는 명시적 인수를 통해 Scanlume API key를 요구합니다.
원격 파일 URL을 OCR 처리할 수 있나요?
아니요. 문서화된 공개 API는 원격 파일 URL이 아니라 전체 base64 data URL을 기대합니다.

개발자 세부 정보

작성자

daanaagua

라이선스

MIT

Skillstore 리비전

r1

버전 안내

작성자가 버전을 선언하지 않았습니다.

리포지토리

https://github.com/daanaagua/scanlume-ocr-api/tree/main/skills/scanlume-ocr-api

참조

7e9e368dc1a370f2040369ebcd0db06d90cb48e5

유지보수 최신성

2026. 7. 23.

사용량

9 다운로드 · 146 조회

파일 구조

📁 agents/

📄 openai.yaml

📁 references/

📄 api-contract.md

📄 output-shapes.md

📁 scripts/

📄 scanlume_ocr.py

📄 SKILL.md

daanaagua의 다른 스킬

전체 보기

관련 스킬

전체 보기