---
name: phix-seo-aeo-publisher
description: Generate and inject SEO/AEO metadata (títulos, descripciones, FAQs, entidades about/mentions y citaciones E-E-A-T) into WordPress using the Agencia SEO AEO Suite REST API for any newly created or existing PHIX article.
metadata:
  short-description: Optimize and inject AEO/SEO metadata for WordPress posts
---

# PHIX SEO/AEO Publisher

Use this skill when you need to optimize and automatically publish/inject SEO and AEO metadata for a newly created or existing article on the PHIX website (`https://medtoledo.com/phix`).

This skill communicates directly with the **Agencia SEO AEO Suite** WordPress plugin REST API.

---

## 1. Credentials & Authentication

> ⚠️ ARCHIVADA — 2026-07-30. Reemplazada por `content-blueprint` + `article-developer`.
> La credencial que estaba escrita aquí fue retirada. **Debe revocarse en WordPress.**

Basic Authentication. Leer siempre de variables de entorno, nunca del archivo:

- **Username:** `{{WP_USER}}`
- **Application Password:** `{{WP_APP_PASSWORD}}`
- **API Endpoint:** `{{WP_URL}}/wp-json/agencia/v1/inject-seo`

---

## 2. Metadata Extraction & Generation Workflow

For any target article content, perform the following analysis:

### A. Core SEO Metadata
- **Focus Keyword:** Select the main keyword of the article (e.g. `ácidos amargos del lúpulo`, `sistema nervioso parasimpático`).
- **Cluster Keywords:** Identify 3-5 related search queries found in the text.
- **SEO Title:** Generate a title (50-60 characters) formatted as `[Hook Title] | PHIX` or `[Topic] | Ciencia y Salud | PHIX`.
- **Meta Description:** Write a 140-150 character summary explaining what the article teaches. Ensure it is commercial and informative.

### B. AI Search (AEO) Entities
Find and map the key entities to their Wikipedia or Wikidata URLs to help LLMs (Gemini, ChatGPT) understand the precise semantic meaning:
- **`about_entities` (Primary topics):** Map the 1-2 main topics of the article. Format: `[{"name": "Nervio Vago", "url": "https://es.wikipedia.org/wiki/Nervio_vago"}]`.
- **`mentions_entities` (Secondary topics):** Map 2-4 auxiliary concepts mentioned. Format: `[{"name": "AMPK", "url": "https://es.wikipedia.org/wiki/AMPK"}]`.

### C. E-E-A-T Citations
- Search the article for any scientific reference (e.g. PubMed IDs, DOI links, or clinical trial mentions).
- Compile a list of full URLs of these studies (e.g. `https://pubmed.ncbi.nlm.nih.gov/xxxx/`). If none are present, search PubMed for a relevant paper on Mature Hop Bitter Acids (MHBA) or Vagus Nerve stimulation related to the article topic and include it as a citation to boost E-E-A-T.

### D. FAQs (Structured Data)
- Extract or write 3-4 Question/Answer pairs directly answered in the article. Keep the answers concise and factual.

### E. Product Data (Optional)
If the article is a sales landing page or directly promotes buying PHIX, include:
- `price`: `999.00` (or current price)
- `currency`: `MXN`
- `sku`: `PHIX-SUPP-01`
- `brand`: `PHIX`
- `availability`: `InStock`

---

## 3. Ingestion REST Payload Format

Send an HTTP `POST` request to `https://medtoledo.com/phix/wp-json/agencia/v1/inject-seo` with the header `Content-Type: application/json` and the following payload:

```json
{
  "post_id": 123, // Target post or page ID in WordPress
  "meta_title": "...",
  "meta_description": "...",
  "canonical_url": "https://medtoledo.com/phix/...", // Full permalink of the post
  "robots_meta": ["index", "follow", "max-image-preview:large"],
  "focus_keyword": "...",
  "cluster_keywords": ["...", "..."],
  "about_entities": [
    { "name": "Nervio Vago", "url": "https://es.wikipedia.org/wiki/Nervio_vago" }
  ],
  "mentions_entities": [
    { "name": "Lúpulo", "url": "https://es.wikipedia.org/wiki/Humulus_lupulus" }
  ],
  "citations": [
    "https://pubmed.ncbi.nlm.nih.gov/xxxxxx/"
  ],
  "faq": [
    {
      "question": "¿...",
      "answer": "..."
    }
  ],
  "product_data": { // Optional
    "price": "999.00",
    "currency": "MXN",
    "sku": "PHIX-SUPP-01",
    "brand": "PHIX",
    "availability": "InStock"
  }
}
```

---

## 4. Verification

After calling the API:
1. Verify the response is status `200` and contains `{"success": true}`.
2. Fetch the page HTML head using `read_url_content` to confirm that:
   - The `<title>` is correctly filtered.
   - The `<meta name="description">` matches the injected text.
   - The `@graph` script block is rendered and includes the injected `about`, `mentions`, `citation`, and `FAQPage` nodes.
