# SiteScore MCP Server

MCP (Model Context Protocol) server for website auditing. Analyzes websites for SEO, performance, accessibility, mobile-friendliness, and security using AI-powered analysis.

## Features

- **SEO Analysis**: Title, meta description, headings, canonical tags, Open Graph, structured data
- **Performance**: HTML size, script count, stylesheet analysis
- **Mobile**: Viewport meta tag, touch-friendly patterns
- **Accessibility**: ARIA labels, roles, heading structure, lang attribute
- **Security**: HTTPS, HSTS, X-Frame-Options, CSP, mixed content detection

## Installation

```bash
npm install
npm run build
```

## Usage

### As MCP Server

Add to your MCP client configuration:

```json
{
  "mcpServers": {
    "sitescore": {
      "command": "node",
      "args": ["/path/to/sitescore-mcp/dist/index.js"],
      "env": {
        "ANTHROPIC_API_KEY": "your-api-key"
      }
    }
  }
}
```

### Environment Variables

- `ANTHROPIC_API_KEY` - Required. Your Anthropic API key for AI analysis.

## Tools

### analyze_website

Analyze a website and get a comprehensive audit report.

**Input:**
```json
{
  "url": "https://example.com"
}
```

**Output:**
```json
{
  "overallScore": 75,
  "categories": {
    "seo": 80,
    "performance": 70,
    "mobile": 85,
    "accessibility": 65,
    "security": 75
  },
  "summary": "The site has good basic SEO but needs improvement in accessibility and security headers.",
  "issues": [
    {
      "severity": "critical",
      "category": "Security",
      "title": "Missing Content-Security-Policy",
      "description": "The site does not have a Content-Security-Policy header...",
      "fix": "Add the header: Content-Security-Policy: default-src 'self'..."
    }
  ]
}
```

## Development

```bash
# Run in development mode
npm run dev

# Run tests
npm run test:dev

# Build for production
npm run build
npm start
```

## License

MIT