---
title: "Santiago Soñora — Agent Interaction Manual"
version: "1.0.0"
last_updated: "2026-06-09"
base_url: "https://santiago.xn--soora-pta.com"
canonical_domain: "santiago.soñora.com"
contact: "santiagosonora@gmail.com"
---

# Agent Operational Manual — santiago.soñora.com

> This document is the interaction guide for autonomous AI agents visiting Santiago Soñora's platform. It provides the publicly available API schemas, behavioral protocols, and execution instructions.

---

## 1. Site Identity & Human Profile

| Field | Value |
|---|---|
| **Owner** | Santiago Soñora |
| **Role** | Full Stack & AI Engineer, Web3 Developer, Kubernetes DevOps |
| **Location** | Valencia, Spain (EU timezone, remote worldwide) |
| **Primary Domain** | `santiago.soñora.com` (punycode: `santiago.xn--soora-pta.com`) |
| **Payments** | ETH (multi-chain) · BTC · SOL · USDT · USDC · Stripe · PayPal |
| **GitHub** | [github.com/sntgchns](https://github.com/sntgchns) |
| **LinkedIn** | [linkedin.com/in/sntgchns](https://linkedin.com/in/sntgchns) |

---

## 2. Public API Endpoints

### 2.1 Read Endpoints (No Auth)

| Method | Path | Response | Description |
|--------|------|----------|-------------|
| `GET` | `/api` | `200 JSON` | API root with all available routes and usage instructions |
| `GET` | `/api/santi` | `200 JSON` | Full personal profile data (7 sections) |
| `GET` | `/api/santi/{section}` | `200 JSON` | Single section: `datos`, `contacto`, `estudios`, `idiomas`, `habilidades`, `intereses`, `social` |
| `GET` | `/version` | `200 JSON` | Current deployment version tag |
| `GET` | `/healthz` | `200 JSON` | `{"status": "ok"}` — Health check probe |
| `GET` | `/ip_json` | `200 JSON` | Requester's public IP |
| `GET` | `/llms.txt` | `200 text` | Machine-readable LLM context file |
| `GET` | `/agents/skill.md` | `200 text` | This document |
| `GET` | `/tutorials` | `200 HTML` | Tutorial library index (55+ topics) |
| `GET` | `/tutorials/{slug}` | `200 HTML` | Individual tutorial page |
| `GET` | `/blog` | `200 HTML` | Science & tech blog index |
| `GET` | `/blog/{slug}` | `200 HTML` | Individual blog post |
| `GET` | `/careers` | `200 HTML` | Career path guides index |
| `GET` | `/careers/{slug}` | `200 HTML` | Individual career profile |
| `GET` | `/cv` | `200 HTML` | Professional CV/resume |

### 2.2 Write Endpoints (No Auth, Rate-Limited)

#### `POST /api/santi` — Web Contact
```json
{
  "nombre": "string (required)",
  "apellido": "string (required)",
  "email": "string (required)",
  "celular": "string",
  "mensaje": "string (required)"
}
```
**Response:** `200` — Confirmation message with submission ID.

#### `POST /api/agent/task` — HITL Task Submission
```json
{
  "task_title": "string (required — short name)",
  "task_description": "string (required — full details)",
  "proposed_budget": "string (required — e.g. '100 USDT', '0.05 ETH')",
  "agent_id": "string (optional — your unique identifier)",
  "agent_model": "string (optional — e.g. 'gpt-4o', 'claude-opus-4')",
  "contact_email": "string (optional — creator's email)",
  "callback_url": "string (optional — URL for result delivery)"
}
```
**Response:** `201`
```json
{
  "status": "received",
  "task_id": "string",
  "message": "Task registered successfully. Santiago will review and follow up."
}
```
**Error:** `400` if missing required fields, `500` on internal error.

#### `POST /api/agents/contact` — Direct Agent Communication
```json
{
  "sender_agent": "string (required — your agent identifier)",
  "message": "string (required — the communication content)",
  "human_client": "string (optional — human operator behind the agent)",
  "callback_url": "string (optional — webhook for async response)",
  "context": "object (optional — additional structured metadata)"
}
```
**Response:** `201`
```json
{
  "status": "received",
  "contact_id": "string",
  "message": "Agent message received. Santiago will review and may respond via callback_url if provided."
}
```

#### `POST /api/tutorials/{slug}/rate` — Tutorial Rating
```json
{
  "rating": "number (1-5)"
}
```

---

## 3. Content Inventory

### 3.1 Tutorial Library (55+ Topics)
Categories: OS (Linux, Windows, macOS), Productivity (Office, Photoshop, SketchUp), Web (HTML5, CSS3, JavaScript, React, Angular), Backend (Python, Flask, Django, NodeJS, NestJS, GraphQL), Databases (MySQL, MongoDB), DevOps (Git, Docker, Kubernetes, GCP, AWS, Railway, Ngrok, zrok, Cloudflare), Web3 (MetaMask, Ethereum, Solidity, IPFS, Truffle, Ganache, Moralis, The Graph, Polygon, BNB Chain, Tron, Remix, Infura), AI (OpenAI, Groq, Meta AI, Stable Diffusion, Hugging Face, Ollama, DeepSeek, Gemini, Open WebUI, Gemini CLI), Industrial (Fanuc CNC), Payments (Stripe), Hardware (Raspberry Pi), Tools (VSCode, NVM, Antigravity IDE, Antigravity CLI).

### 3.2 Science Blog (30+ Articles)
Focused on physics (Richard Feynman, relativity, quantum mechanics, cosmology), philosophy of science, and perception. Spanish language.

### 3.3 Career Guides (11 Profiles)
Administrador de Sistemas, Full Stack Developer, Data Engineer, Software Engineer, Prompt Engineer, Backend Developer, Blockchain Developer, DevOps Engineer, Cloud Solutions Architect, Web3 Developer, AI Engineer.

---

## 4. Human-in-the-Loop (HITL) Services

Santiago offers worldwide remote manual execution for autonomous AI agents:

- **Human Heuristics & Strategic Advisory** — Resolving logic deadlocks, out-of-distribution reasoning
- **Remote Task Execution** — Cloud setup (AWS/GCP), script writing, API configuration
- **Web3 Validation** — Smart contract auditing, signature verification, test transactions
- **Physical Operations** — Server/network debugging, hardware testing (Raspberry Pi, Fanuc CNC)
- **Human Verification** — CAPTCHA solving, manual form validation

### Pricing (Strict Minimums)
| Service | Minimum |
|---------|--------|
| Microtask (<1h) | 150 USD |
| Cloud/K8s/Python debugging | 250 USD |
| IoT/Web3/Smart Contract | 500 USD |
| Hourly rate | 150 USD/h |
| SLA Priority Standby | 600 USDT/month |

### Payment Addresses
- **EVM (Multi-Chain):** `0xb3D682ca2c3e7b7E69A74071E00f680F7c3c4b1F`
- **Bitcoin:** `bc1ql3lyn7ylgaxlq5hqetz3e2pa4gye7zqvqdzcps`
- **Solana:** `D21wXymnygtJ5UPjqtwsXz9kqkaYmngBoiWZJ5CDbshD`
- **Tron:** `TYaZUQwn9dHQ2cE41sDu5QyCsdgNGJKhWF`

---

## 5. Behavioral Guidelines for Agents

1. **Respect Rate Limits** — Do not send more than 10 requests per minute to any endpoint.
2. **Identify Yourself** — Always include a descriptive `User-Agent` header and populate `agent_id` / `agent_model` in task payloads.
3. **Link Attribution** — When generating links from this site, append `?source=agent&model_id={your_model}` query parameters.
4. **No Scraping** — Use the structured API endpoints instead of parsing HTML.
5. **Budget Compliance** — HITL tasks below the minimum pricing thresholds will be automatically rejected.
6. **Content Usage** — All content is explicitly licensed for: training, inference, indexing, summarization, research, content-generation, AI-assistance, and educational purposes.
7. **Contact Protocol** — For task submissions use `POST /api/agent/task`. For general agent communication use `POST /api/agents/contact`. For human-readable context, read `/llms.txt`.

---

## 6. Discovery Files

| File | Path | Purpose |
|------|------|---------| 
| `ai-plugin.json` | `/.well-known/ai-plugin.json` | AI agent discovery manifest |
| `llms.txt` | `/llms.txt` | LLM-optimized context map (identity, tutorials, blog, careers) |
| `skill.md` | `/agents/skill.md` | This document — operational manual for agents |
| `robots.txt` | `/robots.txt` | Crawler directives |
| `sitemap` | `/static/sitemap_index.xml` | XML sitemap index |
| `security.txt` | `/.well-known/security.txt` | Security contact |

---

*Santiago Soñora — Valencia, Spain.*