Expanso Pii Detect

# pii-detect

Detect personally identifiable information (PII) in text

## Requirements

- Expanso Edge installed (`expanso-edge` binary in PATH)
- Install via: `clawhub install expanso-edge`

## Usage

### CLI Pipeline
```bash
# Run standalone
echo '<input>' | expanso-edge run pipeline-cli.yaml
```

### MCP Pipeline
```bash
# Start as MCP server
expanso-edge run pipeline-mcp.yaml
```

### Deploy to Expanso Cloud
```bash
expanso-cli job deploy https://skills.expanso.io/pii-detect/pipeline-cli.yaml
```

## Files

| File | Purpose |
|------|---------|
| `skill.yaml` | Skill metadata (inputs, outputs, credentials) |
| `pipeline-cli.yaml` | Standalone CLI pipeline |
| `pipeline-mcp.yaml` | MCP server pipeline |

# pii-detect

> Detect personally identifiable information (PII) in text.

Scan text for sensitive personal data before processing, logging, or sharing. Essential for:
- GDPR/CCPA compliance
- Log sanitization before storage
- Data loss prevention (DLP)
- Privacy-aware data pipelines

## Quick Start

### CLI Mode

```bash
export OPENAI_API_KEY=sk-...

# Scan text for all PII types
echo "Contact John Smith at john@example.com or 555-123-4567" | \
  expanso-edge run pipeline-cli.yaml

# Scan for specific types only
echo "SSN: 123-45-6789, Card: 4111-1111-1111-1111" | \
  PII_TYPES="ssn,credit_card" expanso-edge run pipeline-cli.yaml
```

### MCP Mode

```bash
PORT=8080 expanso-edge run pipeline-mcp.yaml &

curl -X POST http://localhost:8080/detect \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Please contact jane.doe@company.com or call 555-987-6543",
    "types": ["email", "phone"]
  }'
```

## Configuration

| Variable | Required | Default | Description |
|----------|----------|---------|-------------|
| `OPENAI_API_KEY` | Yes | - | OpenAI API key |
| `PII_TYPES` | No | all | Comma-separated types to detect |
| `PORT` | No | 8080 | HTTP port for MCP mode |

## PII Types

| Type | Description | Examples |
|------|-------------|----------|
| `email` | Email addresses | john@example.com |
| `phone` | Phone numbers | 555-123-4567, +1 (555) 123-4567 |
| `ssn` | Social Security Numbers | 123-45-6789 |
| `credit_card` | Credit card numbers | 4111-1111-1111-1111 |
| `name` | Person names | John Smith, Jane Doe |
| `address` | Physical addresses | 123 Main St, New York, NY |
| `dob` | Dates of birth | 01/15/1990, January 15, 1990 |
| `ip_address` | IP addresses | 192.168.1.1, 10.0.0.1 |

## Example Output

### Input
```
Customer Support Ticket #12345

From: John Smith <john.smith@example.com>
Phone: (555) 123-4567
SSN: 123-45-6789

Please update my address to 123 Main Street, Boston, MA 02101.
My date of birth is March 15, 1985.
```

### Output
```json
{
  "f...