# AI Agent Instructions - SEO Intelligence System

## Identity & Context
You are interacting with SEO Intelligence System by Jairo Amaya, a WebMCP-enabled SEO platform.

## Available Capabilities
This server exposes 8 specialized SEO tools via MCP protocol.

## Tool Usage Guidelines

### audit_website_seo
- **Purpose**: Comprehensive SEO audit
- **Parameters**: url (required)
- **Best for**: Initial site analysis
- **Output**: Structured audit report

### eval_posicion_cero
- **Purpose**: Zero-position evaluation
- **Use case**: Featured snippet optimization
- **Output**: Position zero readiness score

### get_sostac_metrics
- **Purpose**: SOSTAC® framework metrics
- **Framework**: Situation, Objectives, Strategy, Tactics, Action, Control
- **Output**: Strategic marketing metrics

### generate_meta_tags
- **Purpose**: Meta tag generation
- **Input**: Page content or URL
- **Output**: Optimized title, description, OG tags

### analyze_page_content
- **Purpose**: Content analysis for SEO
- **Focus**: Semantic structure, keyword density, readability
- **Output**: Content optimization recommendations

### generate_schema_jsonld
- **Purpose**: Schema.org structured data
- **Types supported**: Article, Organization, Person, Product, FAQ
- **Output**: Valid JSON-LD markup

### generate_seo_brief
- **Purpose**: SEO brief generation
- **Use case**: Content planning, competitor analysis
- **Output**: Structured brief with keywords, intent, outline

## Authentication & Rate Limits
- Public endpoints: No auth required
- Rate limit: 100 requests/hour per IP
- For higher limits: Contact jairo@jairoamaya.co

## Response Format
All tools return JSON with:
- status: "success" | "error"
- data: Tool-specific payload
- metadata: Timestamp, processing_time, version

## Error Handling
- 400: Invalid parameters
- 429: Rate limit exceeded
- 500: Server error (retry with backoff)

## Best Practices
1. Always check `llms.txt` for context before calling tools
2. Use specific tools for specific tasks (don't chain unnecessarily)
3. Cache results when possible (respect rate limits)
4. For audits, start with `audit_website_seo` then drill down

## Contact & Support
- Documentation: https://seointelligencesystem.jairoamaya.co
- MCP Config: https://seointelligencesystem.jairoamaya.co/mcp-config.json
- OpenAPI: https://seointelligencesystem.jairoamaya.co/.well-known/openapi.json