어떻게 난 지저분한 텍스트를 깔끔한 JSON으로 변환하는 API를 만들었는지 (무료로 사용할 수 있어요)

Source: Dev.to

개요

모든 개발자는 영수증, 이메일, 이력서 등과 같은 지저분하고 비구조화된 텍스트를 다뤄본 경험이 있습니다. 가치 있는 데이터는 평문에 숨겨져 있으며, 기존의 정규식 솔루션은 깨지기 쉽고 수동 파싱은 번거롭습니다. StructureAI는 단일 API 호출로 이 문제를 해결합니다: 텍스트를 입력하면 깔끔하고 구조화된 JSON을 반환합니다.

예시: 영수증 파싱

입력 텍스트

Receipt from Whole Foods 03/15/2024
Apples $3.99
Milk $5.49
Bread $4.29
Tax $1.18
Total: $14.95
Card ending 4242

원하는 JSON 출력

{
  "merchant": "Whole Foods",
  "date": "2024-03-15",
  "items": [
    { "name": "Apples", "price": 3.99 },
    { "name": "Milk", "price": 5.49 },
    { "name": "Bread", "price": 4.29 }
  ],
  "tax": 1.18,
  "total": 14.95,
  "payment_method": "Card ending 4242"
}

API 사용법

curl -X POST https://api-service-wine.vercel.app/api/extract \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_KEY" \
  -d '{
    "text": "Receipt from Whole Foods 03/15/2024...",
    "schema": "receipt"
  }'

API는 구조화된 JSON과 함께 신뢰도 점수를 반환합니다. 영수증, 청구서, 이메일, 이력서, 연락처 또는 사용자가 정의한 모든 커스텀 스키마에 대해 동작합니다.

지원 스키마

커스텀 스키마 예시: 제품 리뷰

curl -X POST https://api-service-wine.vercel.app/api/extract \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_KEY" \
  -d '{
    "text": "Love this laptop! Battery lasts 12 hours. Screen is gorgeous. Only downside is the keyboard feels mushy. 4/5 stars.",
    "schema": "custom",
    "custom_fields": ["product_type", "pros", "cons", "rating", "sentiment"]
  }'

응답

{
  "product_type": "laptop",
  "pros": ["12 hour battery life", "gorgeous screen"],
  "cons": ["mushy keyboard"],
  "rating": "4/5",
  "sentiment": "positive"
}

MCP 서버 통합 (Claude Desktop / Cursor)

Claude Desktop이나 Cursor를 사용한다면 무료 요청을 위해 MCP 서버를 설치할 수 있습니다.

git clone https://github.com/avatrix1/structureai-mcp.git
cd structureai-mcp && npm install && npm run build

Claude Desktop 설정에 서버를 추가합니다:

{
  "mcpServers": {
    "structureai": {
      "command": "node",
      "args": ["/path/to/structureai-mcp/dist/index.js"]
    }
  }
}

그런 다음 Claude에게 간단히 물어보세요. 예: “이 텍스트에서 영수증 데이터를 추출해 주세요: …”.

가격 정책

• 무료 티어 (MCP): 월 10회 요청.
• API 키: 100회 요청당 $2.

API 키는 https://api-service-wine.vercel.app 에서 발급받으세요.

연락처

Avatrix LLC에서 제작했습니다. 문의 사항은 support@avatrix.co 로 이메일 주세요.