medical-record-structurer

# Medical Record Structurer

> **Version**: 1.0.4  
> **Category**: Healthcare / Medical  
> **Billing**: SkillPay (0.001 USDT per call)  
> **Free Trial**: 10 free calls per user

A professional medical record processing tool that transforms unstructured medical notes (voice or text) into standardized electronic medical records.

## Features

1. **Voice/Text Input Processing** - Accepts doctor's口述 or handwritten notes
2. **AI-Powered Field Extraction** - Automatically identifies and extracts medical fields
3. **Standardized EMR Output** - Generates structured electronic medical records
4. **Payment Integration** - skillpay.me integration for monetization (0.001 USDT per use)
5. **Free Trial** - 10 free calls for every new user

## Free Trial

Each user gets **10 free calls** before billing begins. During the trial:
- No payment required
- Full feature access
- Trial status returned in API response

```python
{
    "success": True,
    "trial_mode": True,      # Currently in free trial
    "trial_remaining": 5,    # 5 free calls left
    "balance": None,         # No balance needed in trial
    "structured_record": {...}
}
```

After 10 free calls, normal billing applies.

## Quick Start

### Process a medical record:

```python
from scripts.process_record import process_medical_record
import os

# Set API key via environment variable (only needed after trial)
os.environ["SKILLPAY_API_KEY"] = "your-api-key"

# Process with user_id for billing/trial tracking
result = process_medical_record(
    input_text="患者张三，男，45岁，主诉头痛3天...",
    user_id="user_123"
)

# Check result
if result["success"]:
    print("结构化病历:", result["structured_record"])
    if result.get("trial_mode"):
        print(f"免费试用剩余: {result['trial_remaining']} 次")
    else:
        print("剩余余额:", result["balance"])
else:
    print("错误:", result["error"])
    if "paymentUrl" in result:
        print("充值链接:", result["paymentUrl"])
```

### API Usage:

```bash
# Set API...

# Medical Record Structurer

A professional medical record processing tool that transforms unstructured medical notes (voice or text) into standardized electronic medical records (EMR).

## Features

- **Voice/Text Input Processing** - Accepts doctor's口述 or handwritten notes
- **AI-Powered Field Extraction** - Automatically identifies and extracts medical fields
- **Standardized EMR Output** - Generates structured electronic medical records
- **Payment Integration** - skillpay.me integration for pay-per-use monetization (0.001 USDT per use)
- **OCR Support** - Process handwritten medical records via image recognition
- **STT Support** - Process voice recordings via speech-to-text

## Installation

1. Clone or download this skill to your OpenClaw workspace:
```bash
cd /home/node/.openclaw/workspace/skills/
```

2. Install Python dependencies (if any additional packages are needed):
```bash
pip install -r requirements.txt  # if requirements.txt exists
```

3. Copy the environment variables file and configure:
```bash
cp .env.example .env
# Edit .env with your actual API keys
```

## Environment Variables Configuration

Copy `.env.example` to `.env` and configure the following variables:

### Required Variables

| Variable | Description | Required |
|----------|-------------|----------|
| `SKILLPAY_API_KEY` | Your SkillPay API key for billing | Yes |
| `SKILLPAY_SKILL_ID` | Your Skill ID from SkillPay dashboard | Yes |

### Optional Variables

| Variable | Description | Default |
|----------|-------------|---------|
| `OCR_API_KEY` | API key for OCR services (image processing) | - |
| `OCR_PROVIDER` | OCR provider (google, azure, aws, tesseract) | google |
| `STT_API_KEY` | API key for speech-to-text services | - |
| `STT_PROVIDER` | STT provider (google, azure, aws, whisper) | whisper |
| `PHI_ENCRYPTION_KEY` | Encryption key for PHI protection | - |
| `DATA_RETENTION_DAYS` | Days to retain processed records | 30 |
| `AUDIT_LOGGING_ENABLED` | Enable audit logging |...