@frase/mcp-server 0.3.0 → 0.3.2

package/dist/prompts/content-pipeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"content-pipeline.d.ts","sourceRoot":"","sources":["../../src/prompts/content-pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,eAAO,MAAM,qBAAqB,EAAE,mBAoCnC,CAAC;AAEF,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,KAAK,CAAC;IAC9E,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACzC,CAAC,CA4DD"}
+{"version":3,"file":"content-pipeline.d.ts","sourceRoot":"","sources":["../../src/prompts/content-pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,eAAO,MAAM,qBAAqB,EAAE,mBAoCnC,CAAC;AAEF,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,KAAK,CAAC;IAC9E,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACzC,CAAC,CAoDD"}

package/dist/prompts/content-pipeline.js

@@ -34,7 +34,7 @@ export const contentPipelinePrompt = {
         },
         {
             name: "content_type",
-            description: "Type of content: blog, guide, listicle, comparison, landing (default: blog)",
+            description: "Type of content: blog, guide, comparison, landing, product (default: blog)",
             required: false,
         },
         {
@@ -72,32 +72,24 @@ export function getContentPipelineMessages(args) {
 
 **Execute these steps in order:**
 
-**Step 1 — Research:** Use start_research with the topic "${topic}" to gather insights. Wait for completion using get_job_status (poll every 5 seconds). Then retrieve results with get_research. If research fails after 3 polls with "failed" status, log the error and continue to Step 2 — SERP data alone is sufficient to proceed.
+**Step 1 — Research:** Use start_research with query "${topic}" and site_id "${siteId}". This runs keywords, SERP analysis, content gaps, evidence, and AI visibility in parallel. Wait for completion using get_job_status (poll every 5 seconds). Then retrieve results with get_research to confirm keywords, competitors, and gaps were found. If research fails after 3 polls with "failed" status, report the error and stop.
 
-**Step 2 — SERP Analysis:** Use analyze_serp for "${topic}" (country: ${targetCountry}, language: ${targetLanguage}) to understand the competitive landscape. Also use get_search_intent to classify the query intent. If SERP analysis fails, report the error and stop — the pipeline cannot proceed without SERP data.
-
-**Step 3 — Competitor Analysis:** Use analyze_competitors for "${topic}" to identify content gaps and opportunities in the top-ranking pages. If this fails, continue — competitor data enriches but isn't required.
-
-**Step 4 — Create Brief:** Use create_brief with:
-- topic: "${topic}"
-- generate_outline: true
+**Step 2 — Create Brief:** Use create_brief with:
+- research_session_id: the ID from Step 1
 - content_type: "${contentType}"
-- site_id: "${siteId}"
-- target_language: "${targetLanguage}"
-- target_country: "${targetCountry}"
-Wait for the brief to complete using get_job_status (poll every 5 seconds, up to 60 polls / 5 minutes). Then use get_brief to retrieve the full outline. If brief generation fails or times out, report the error and stop — content cannot be generated without a brief.
+This creates a research-backed brief using the full research context (keywords, SERP headings, content gaps, evidence, AI visibility, search intent). Wait for the brief to be ready using get_job_status with type "brief" (poll every 5 seconds, up to 60 polls / 5 minutes). Then use get_brief to retrieve the full outline. If brief generation fails or times out, report the error and stop.
 
-**Step 5 — Generate Content:** Use generate_content with the brief ID. Wait for completion using get_job_status (poll every 10 seconds, up to 30 polls / 5 minutes). Retrieve the generated content with get_content. If content generation fails or times out, report the error and stop.
+**Step 3 — Generate Content:** Use generate_content with the brief ID. Wait for completion using get_job_status (poll every 10 seconds, up to 30 polls / 5 minutes). Retrieve the generated content with get_content. If content generation fails or times out, report the error and stop.
 
-**Step 6 — Optimize:** Use start_optimization with the content ID. Wait for analysis to complete (poll every 5 seconds), then use get_optimization to review the score and suggestions.
+**Step 4 — Optimize:** Use start_optimization with the content ID. Wait for analysis to complete (poll every 5 seconds), then use get_optimization to review the score and suggestions.
 - If the score is below ${targetScore}: apply the highest-priority suggestions using apply_optimization (one call per suggestion_id), then re-run start_optimization and check the new score.
 - Repeat this cycle up to 3 times or until the score meets the target.
 - Report the final score.
-- If optimization fails, skip to Step 7 — content can still be published as a draft for manual optimization.
+- If optimization fails, skip to Step 5 — content can still be published as a draft for manual optimization.
 
-**Step 7 — Publish:** Use list_cms_connections with site_id "${siteId}" to check available platforms. If a CMS is connected, use publish_content with the content ID, destination "frase_cms" (or the connected platform), site_id "${siteId}", and status "draft". Report the published URL. If no CMS connection exists, skip publishing and note this in the report.
+**Step 5 — Publish:** Use list_cms_connections with site_id "${siteId}" to check available platforms. If a CMS is connected, use publish_content with the content ID, destination "frase_cms" (or the connected platform), site_id "${siteId}", and status "draft". Report the published URL. If no CMS connection exists, skip publishing and note this in the report.
 
-**Step 8 — Monitor:** Use create_prompt with prompt_text set to a natural question about "${topic}" (min 10 chars, e.g., "What is the best approach to ${topic}?") and target_brand set to the site's brand name. This tracks whether AI search engines (ChatGPT, Perplexity, Claude, etc.) cite this content. If monitoring setup fails, note it in the report — it can be configured manually later.
+**Step 6 — Monitor:** Use create_prompt with prompt_text set to a natural question about "${topic}" (min 10 chars, e.g., "What is the best approach to ${topic}?") and target_brand set to the site's brand name. This tracks whether AI search engines (ChatGPT, Perplexity, Claude, etc.) cite this content. If monitoring setup fails, note it in the report — it can be configured manually later.
 
 **After all steps, provide a summary report:**
 - Topic and URL

package/dist/prompts/content-pipeline.js.map

@@ -1 +1 @@
-{"version":3,"file":"content-pipeline.js","sourceRoot":"","sources":["../../src/prompts/content-pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,MAAM,CAAC,MAAM,qBAAqB,GAAwB;IACxD,IAAI,EAAE,kBAAkB;IACxB,WAAW,EACT,mNAAmN;IACrN,SAAS,EAAE;QACT;YACE,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,yDAAyD;YACtE,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,6DAA6D;YAC1E,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,cAAc;YACpB,WAAW,EAAE,0EAA0E;YACvF,QAAQ,EAAE,KAAK;SAChB;QACD;YACE,IAAI,EAAE,cAAc;YACpB,WAAW,EAAE,6EAA6E;YAC1F,QAAQ,EAAE,KAAK;SAChB;QACD;YACE,IAAI,EAAE,iBAAiB;YACvB,WAAW,EAAE,iFAAiF;YAC9F,QAAQ,EAAE,KAAK;SAChB;QACD;YACE,IAAI,EAAE,gBAAgB;YACtB,WAAW,EAAE,6EAA6E;YAC1F,QAAQ,EAAE,KAAK;SAChB;KACF;CACF,CAAC;AAEF,MAAM,UAAU,0BAA0B,CAAC,IAA4B;IAIrE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,qBAAqB,CAAC;IAClD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;IAClC,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC;IAC9C,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,IAAI,MAAM,CAAC;IAChD,MAAM,cAAc,GAAG,IAAI,CAAC,eAAe,IAAI,IAAI,CAAC;IACpD,MAAM,aAAa,GAAG,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC;IAElD,OAAO;QACL;YACE,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE;gBACP,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,sCAAsC,KAAK;;;aAG5C,MAAM;kBACD,WAAW;+BACE,WAAW;cAC5B,cAAc;aACf,aAAa;;;;4DAIkC,KAAK;;oDAEb,KAAK,eAAe,aAAa,eAAe,cAAc;;iEAEjD,KAAK;;;YAG1D,KAAK;;mBAEE,WAAW;cAChB,MAAM;sBACE,cAAc;qBACf,aAAa;;;;;;0BAMR,WAAW;;;;;+DAK0B,MAAM,iKAAiK,MAAM;;4FAEhJ,KAAK,wDAAwD,KAAK;;;;;;;gCAO9H;aACzB;SACF;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"content-pipeline.js","sourceRoot":"","sources":["../../src/prompts/content-pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,MAAM,CAAC,MAAM,qBAAqB,GAAwB;IACxD,IAAI,EAAE,kBAAkB;IACxB,WAAW,EACT,mNAAmN;IACrN,SAAS,EAAE;QACT;YACE,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,yDAAyD;YACtE,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,6DAA6D;YAC1E,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,cAAc;YACpB,WAAW,EAAE,0EAA0E;YACvF,QAAQ,EAAE,KAAK;SAChB;QACD;YACE,IAAI,EAAE,cAAc;YACpB,WAAW,EAAE,4EAA4E;YACzF,QAAQ,EAAE,KAAK;SAChB;QACD;YACE,IAAI,EAAE,iBAAiB;YACvB,WAAW,EAAE,iFAAiF;YAC9F,QAAQ,EAAE,KAAK;SAChB;QACD;YACE,IAAI,EAAE,gBAAgB;YACtB,WAAW,EAAE,6EAA6E;YAC1F,QAAQ,EAAE,KAAK;SAChB;KACF;CACF,CAAC;AAEF,MAAM,UAAU,0BAA0B,CAAC,IAA4B;IAIrE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,qBAAqB,CAAC;IAClD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;IAClC,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC;IAC9C,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,IAAI,MAAM,CAAC;IAChD,MAAM,cAAc,GAAG,IAAI,CAAC,eAAe,IAAI,IAAI,CAAC;IACpD,MAAM,aAAa,GAAG,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC;IAElD,OAAO;QACL;YACE,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE;gBACP,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,sCAAsC,KAAK;;;aAG5C,MAAM;kBACD,WAAW;+BACE,WAAW;cAC5B,cAAc;aACf,aAAa;;;;wDAI8B,KAAK,kBAAkB,MAAM;;;;mBAIlE,WAAW;;;;;;0BAMJ,WAAW;;;;;+DAK0B,MAAM,iKAAiK,MAAM;;4FAEhJ,KAAK,wDAAwD,KAAK;;;;;;;gCAO9H;aACzB;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/prompts/create-seo-article.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-seo-article.d.ts","sourceRoot":"","sources":["../../src/prompts/create-seo-article.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,eAAO,MAAM,sBAAsB,EAAE,mBA0CpC,CAAC;AAEF,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,KAAK,CAAC;IAC/E,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACzC,CAAC,CAyED"}
+{"version":3,"file":"create-seo-article.d.ts","sourceRoot":"","sources":["../../src/prompts/create-seo-article.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,eAAO,MAAM,sBAAsB,EAAE,mBA2BpC,CAAC;AAEF,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,KAAK,CAAC;IAC/E,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACzC,CAAC,CA4DD"}

package/dist/prompts/create-seo-article.js

@@ -12,36 +12,21 @@
  */
 export const createSeoArticlePrompt = {
     name: "create_seo_article",
-    description: "Create a complete SEO article from scratch. This workflow researches the topic, creates a brief with outline, generates optimized content, scores and revises until quality threshold is met, publishes to CMS, and sets up AI visibility monitoring.",
+    description: "Create a complete SEO article from scratch. Researches the topic, creates a research-backed brief with outline, generates optimized content, scores and revises until quality threshold is met, publishes to CMS, and sets up AI visibility monitoring.",
     arguments: [
         {
             name: "topic",
             description: "The topic or title for the article (required)",
             required: true,
         },
-        {
-            name: "keywords",
-            description: "Target keywords to optimize for (comma-separated)",
-            required: false,
-        },
-        {
-            name: "content_type",
-            description: "Type of content: blog, guide, listicle, comparison, landing (default: blog)",
-            required: false,
-        },
         {
             name: "site_id",
-            description: "Site ID to associate and publish content to (optional)",
-            required: false,
-        },
-        {
-            name: "target_language",
-            description: "ISO 639-1 language code (e.g., 'en', 'de', 'es'). Defaults to 'en'.",
-            required: false,
+            description: "Site ID to associate research and content with (required). Use list_sites to find your site ID.",
+            required: true,
         },
         {
-            name: "target_country",
-            description: "ISO 3166-1 alpha-2 country code (e.g., 'us', 'de', 'br'). Affects SERP localization.",
+            name: "content_type",
+            description: "Type of content: blog, guide, comparison, landing, product (default: blog)",
             required: false,
         },
         {
@@ -53,18 +38,9 @@ export const createSeoArticlePrompt = {
 };
 export function getCreateSeoArticleMessages(args) {
     const topic = args.topic || "the requested topic";
-    const keywords = args.keywords ? args.keywords.split(",").map((k) => k.trim()) : [];
     const contentType = args.content_type || "blog";
-    const siteId = args.site_id || null;
-    const targetLanguage = args.target_language || null;
-    const targetCountry = args.target_country || null;
+    const siteId = args.site_id || "";
     const targetScore = args.target_score || "70";
-    const keywordText = keywords.length > 0
-        ? `\n- Target keywords: ${keywords.join(", ")}`
-        : "";
-    const siteText = siteId ? `\n- Site ID: ${siteId}` : "";
-    const languageText = targetLanguage ? `\n- Language: ${targetLanguage}` : "";
-    const countryText = targetCountry ? `\n- Country: ${targetCountry}` : "";
     return [
         {
             role: "user",
@@ -73,24 +49,25 @@ export function getCreateSeoArticleMessages(args) {
                 text: `Please help me create a complete SEO article about "${topic}".
 
 Article specifications:
-- Content type: ${contentType}${keywordText}${siteText}${languageText}${countryText}
+- Content type: ${contentType}
+- Site ID: ${siteId}
 - Target optimization score: ${targetScore}+
 
 Please follow these steps:
 
-1. **Research the topic** using start_research to gather insights and understand the search landscape${targetLanguage || targetCountry ? ` (pass language: "${targetLanguage || "en"}"${targetCountry ? `, country: "${targetCountry}"` : ""})` : ""}
+1. **Research the topic** using start_research with query "${topic}" and site_id "${siteId}". Wait for completion using get_job_status (poll every 5 seconds). Then retrieve results with get_research to see keywords, competitors, content gaps, and search intent.
 
-2. **Create a content brief** using create_brief with:
-   - The topic as the title
-   - generate_outline set to true
-   - Any target keywords I provided${siteId ? `\n   - site_id: ${siteId}` : ""}${targetLanguage ? `\n   - target_language: ${targetLanguage}` : ""}${targetCountry ? `\n   - target_country: ${targetCountry}` : ""}
+2. **Create a research-backed brief** using create_brief with:
+   - research_session_id: the ID from step 1
+   - content_type: "${contentType}"
+   This generates a detailed outline from the full research context (keywords, SERP headings, gaps, evidence, AI visibility).
 
-3. **Wait for the brief** to be ready using get_job_status, then get the full brief with get_brief
+3. **Wait for the brief** to be ready using get_job_status with type "brief", then get the full brief with get_brief.
 
 4. **Review the outline** and let me know what was generated, including:
    - The suggested outline structure
    - Key topics to cover
-   - Competitor analysis insights
+   - Research insights used
 
 5. **Ask for my approval** before generating the final content
 
@@ -105,16 +82,14 @@ Please follow these steps:
    - Re-score until the target is met or no more high-priority suggestions remain
    - Report the final optimization score
 
-${siteId ? `9. **Publish to CMS**:
+9. **Publish to CMS**:
    - Use list_cms_connections with site_id "${siteId}" to check available platforms
    - Use publish_content with content_id, destination "frase_cms" (or the connected platform), site_id "${siteId}", and status "draft"
    - Confirm the published URL
 
 10. **Set up AI visibility monitoring**:
     - Use create_prompt with prompt_text set to a natural question about "${topic}" (min 10 chars) and target_brand set to the site's brand name
-    - Confirm the monitoring is active` : `9. **Set up AI visibility monitoring** (optional):
-    - Use create_prompt with prompt_text set to a natural question about "${topic}" (min 10 chars) and target_brand set to your brand name
-    - Confirm the monitoring is active`}
+    - Confirm the monitoring is active
 
 Please start with the research step and guide me through this process.`,
             },

package/dist/prompts/create-seo-article.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-seo-article.js","sourceRoot":"","sources":["../../src/prompts/create-seo-article.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,MAAM,CAAC,MAAM,sBAAsB,GAAwB;IACzD,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EACT,uPAAuP;IACzP,SAAS,EAAE;QACT;YACE,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,+CAA+C;YAC5D,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,UAAU;YAChB,WAAW,EAAE,mDAAmD;YAChE,QAAQ,EAAE,KAAK;SAChB;QACD;YACE,IAAI,EAAE,cAAc;YACpB,WAAW,EACT,6EAA6E;YAC/E,QAAQ,EAAE,KAAK;SAChB;QACD;YACE,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,wDAAwD;YACrE,QAAQ,EAAE,KAAK;SAChB;QACD;YACE,IAAI,EAAE,iBAAiB;YACvB,WAAW,EAAE,qEAAqE;YAClF,QAAQ,EAAE,KAAK;SAChB;QACD;YACE,IAAI,EAAE,gBAAgB;YACtB,WAAW,EAAE,sFAAsF;YACnG,QAAQ,EAAE,KAAK;SAChB;QACD;YACE,IAAI,EAAE,cAAc;YACpB,WAAW,EAAE,4DAA4D;YACzE,QAAQ,EAAE,KAAK;SAChB;KACF;CACF,CAAC;AAEF,MAAM,UAAU,2BAA2B,CAAC,IAA4B;IAItE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,qBAAqB,CAAC;IAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACpF,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,IAAI,MAAM,CAAC;IAChD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC;IACpC,MAAM,cAAc,GAAG,IAAI,CAAC,eAAe,IAAI,IAAI,CAAC;IACpD,MAAM,aAAa,GAAG,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC;IAClD,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC;IAE9C,MAAM,WAAW,GACf,QAAQ,CAAC,MAAM,GAAG,CAAC;QACjB,CAAC,CAAC,wBAAwB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QAC/C,CAAC,CAAC,EAAE,CAAC;IAET,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,gBAAgB,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACxD,MAAM,YAAY,GAAG,cAAc,CAAC,CAAC,CAAC,iBAAiB,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7E,MAAM,WAAW,GAAG,aAAa,CAAC,CAAC,CAAC,gBAAgB,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAEzE,OAAO;QACL;YACE,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE;gBACP,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,uDAAuD,KAAK;;;kBAGxD,WAAW,GAAG,WAAW,GAAG,QAAQ,GAAG,YAAY,GAAG,WAAW;+BACpD,WAAW;;;;uGAI6D,cAAc,IAAI,aAAa,CAAC,CAAC,CAAC,qBAAqB,cAAc,IAAI,IAAI,IAAI,aAAa,CAAC,CAAC,CAAC,eAAe,aAAa,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE;;;;;qCAK/M,MAAM,CAAC,CAAC,CAAC,mBAAmB,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,cAAc,CAAC,CAAC,CAAC,2BAA2B,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,aAAa,CAAC,CAAC,CAAC,0BAA0B,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE;;;;;;;;;;;;;;;;;;6BAkBtL,WAAW;;;;EAItC,MAAM,CAAC,CAAC,CAAC;8CACmC,MAAM;0GACsD,MAAM;;;;4EAIpC,KAAK;uCAC1C,CAAC,CAAC,CAAC;4EACkC,KAAK;uCAC1C;;uEAEgC;aAChE;SACF;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"create-seo-article.js","sourceRoot":"","sources":["../../src/prompts/create-seo-article.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,MAAM,CAAC,MAAM,sBAAsB,GAAwB;IACzD,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EACT,yPAAyP;IAC3P,SAAS,EAAE;QACT;YACE,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,+CAA+C;YAC5D,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,iGAAiG;YAC9G,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,cAAc;YACpB,WAAW,EACT,4EAA4E;YAC9E,QAAQ,EAAE,KAAK;SAChB;QACD;YACE,IAAI,EAAE,cAAc;YACpB,WAAW,EAAE,4DAA4D;YACzE,QAAQ,EAAE,KAAK;SAChB;KACF;CACF,CAAC;AAEF,MAAM,UAAU,2BAA2B,CAAC,IAA4B;IAItE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,qBAAqB,CAAC;IAClD,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,IAAI,MAAM,CAAC;IAChD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;IAClC,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC;IAE9C,OAAO;QACL;YACE,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE;gBACP,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,uDAAuD,KAAK;;;kBAGxD,WAAW;aAChB,MAAM;+BACY,WAAW;;;;6DAImB,KAAK,kBAAkB,MAAM;;;;sBAIpE,WAAW;;;;;;;;;;;;;;;;;;;6BAmBJ,WAAW;;;;;8CAKM,MAAM;0GACsD,MAAM;;;;4EAIpC,KAAK;;;uEAGV;aAChE;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/prompts/keyword-research.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"keyword-research.d.ts","sourceRoot":"","sources":["../../src/prompts/keyword-research.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,eAAO,MAAM,qBAAqB,EAAE,mBAqBnC,CAAC;AAEF,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,KAAK,CAAC;IAC9E,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACzC,CAAC,CA0CD"}
+{"version":3,"file":"keyword-research.d.ts","sourceRoot":"","sources":["../../src/prompts/keyword-research.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,eAAO,MAAM,qBAAqB,EAAE,mBAgBnC,CAAC;AAEF,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,KAAK,CAAC;IAC9E,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACzC,CAAC,CAoCD"}

package/dist/prompts/keyword-research.js

@@ -8,7 +8,7 @@
  */
 export const keywordResearchPrompt = {
     name: "keyword_research",
-    description: "Research keywords for a topic. Analyzes search intent, competition, and identifies content opportunities.",
+    description: "Research keywords for a topic. Runs full research including keyword extraction, SERP analysis, content gaps, and search intent classification.",
     arguments: [
         {
             name: "topic",
@@ -16,21 +16,15 @@ export const keywordResearchPrompt = {
             required: true,
         },
         {
-            name: "country",
-            description: "Two-letter country code for localized results (default: us)",
-            required: false,
-        },
-        {
-            name: "language",
-            description: "Two-letter language code (default: en)",
-            required: false,
+            name: "site_id",
+            description: "Site ID for brand context and localization (required). Use list_sites to find your site ID.",
+            required: true,
         },
     ],
 };
 export function getKeywordResearchMessages(args) {
     const topic = args.topic || "[topic]";
-    const country = args.country || "us";
-    const language = args.language || "en";
+    const siteId = args.site_id || "";
     return [
         {
             role: "user",
@@ -38,33 +32,28 @@ export function getKeywordResearchMessages(args) {
                 type: "text",
                 text: `Please help me research keywords for: "${topic}"
 
-Settings:
-- Country: ${country}
-- Language: ${language}
+Site ID: ${siteId}
 
 Please follow these steps:
 
-1. **Analyze the SERP** using analyze_serp to understand:
-   - Current top-ranking content
-   - Featured snippets
-   - People Also Ask questions
-   - Related searches
-
-2. **Get search intent** using get_search_intent to determine:
-   - Primary intent (informational, transactional, navigational)
-   - Recommended content type and format
+1. **Research the topic** using start_research with query "${topic}" and site_id "${siteId}". Wait for completion using get_job_status. This runs keyword extraction, SERP analysis, content gaps, evidence gathering, and AI visibility analysis in parallel.
 
-3. **Research the topic** using start_research for deeper insights
+2. **Retrieve results** using get_research to see:
+   - Keywords with search volume, difficulty, and categories
+   - SERP competitors and their content structure
+   - Content gaps and opportunities
+   - Questions people ask about this topic
+   - Search intent analysis
 
-4. **Present your findings** including:
-   - Main keyword opportunities
-   - Long-tail variations
-   - Content gaps to exploit
-   - Recommended content angle
+3. **Present your findings** including:
+   - Top keyword opportunities (sorted by volume and difficulty)
+   - Content gaps worth exploiting
+   - Search intent breakdown
+   - Recommended content angle based on the competitive landscape
 
-5. **Suggest next steps** for creating content based on the research
+4. **Suggest next steps** — offer to create a research-backed brief using create_brief with the research_session_id
 
-Please start with the SERP analysis.`,
+Please start with the research.`,
             },
         },
     ];

package/dist/prompts/keyword-research.js.map

@@ -1 +1 @@
-{"version":3,"file":"keyword-research.js","sourceRoot":"","sources":["../../src/prompts/keyword-research.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,CAAC,MAAM,qBAAqB,GAAwB;IACxD,IAAI,EAAE,kBAAkB;IACxB,WAAW,EACT,2GAA2G;IAC7G,SAAS,EAAE;QACT;YACE,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,kDAAkD;YAC/D,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,6DAA6D;YAC1E,QAAQ,EAAE,KAAK;SAChB;QACD;YACE,IAAI,EAAE,UAAU;YAChB,WAAW,EAAE,wCAAwC;YACrD,QAAQ,EAAE,KAAK;SAChB;KACF;CACF,CAAC;AAEF,MAAM,UAAU,0BAA0B,CAAC,IAA4B;IAIrE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,SAAS,CAAC;IACtC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC;IACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC;IAEvC,OAAO;QACL;YACE,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE;gBACP,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,0CAA0C,KAAK;;;aAGhD,OAAO;cACN,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;qCAwBe;aAC9B;SACF;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"keyword-research.js","sourceRoot":"","sources":["../../src/prompts/keyword-research.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,CAAC,MAAM,qBAAqB,GAAwB;IACxD,IAAI,EAAE,kBAAkB;IACxB,WAAW,EACT,gJAAgJ;IAClJ,SAAS,EAAE;QACT;YACE,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,kDAAkD;YAC/D,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,6FAA6F;YAC1G,QAAQ,EAAE,IAAI;SACf;KACF;CACF,CAAC;AAEF,MAAM,UAAU,0BAA0B,CAAC,IAA4B;IAIrE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,SAAS,CAAC;IACtC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;IAElC,OAAO;QACL;YACE,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE;gBACP,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,0CAA0C,KAAK;;WAElD,MAAM;;;;6DAI4C,KAAK,kBAAkB,MAAM;;;;;;;;;;;;;;;;;gCAiB1D;aACzB;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/resources/briefs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"briefs.d.ts","sourceRoot":"","sources":["../../src/resources/briefs.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,WAAW,EAIZ,MAAM,aAAa,CAAC;AA+BrB,eAAO,MAAM,UAAU,mBAAmB,CAAC;AAC3C,eAAO,MAAM,gBAAgB,oBAAoB,CAAC;AAMlD,eAAO,MAAM,sBAAsB;;;;;GAOlC,CAAC;AAMF,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,aAAa,EAAE,CAAC,CAsC1B;AAMD,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,CAAC,CAWjB;AAsGD,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEpD"}
+{"version":3,"file":"briefs.d.ts","sourceRoot":"","sources":["../../src/resources/briefs.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,WAAW,EAIZ,MAAM,aAAa,CAAC;AAgCrB,eAAO,MAAM,UAAU,mBAAmB,CAAC;AAC3C,eAAO,MAAM,gBAAgB,oBAAoB,CAAC;AAMlD,eAAO,MAAM,sBAAsB;;;;;GAOlC,CAAC;AAMF,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,aAAa,EAAE,CAAC,CAsC1B;AAMD,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,CAAC,CAWjB;AA6GD,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEpD"}

package/dist/resources/briefs.js

@@ -6,7 +6,7 @@
  * - frase://briefs/{id} - Individual brief with outline
  */
 import { CACHE_TTL } from "../cache.js";
-import { formatKeyValue, formatDate, formatStatus, truncate } from "../formatter.js";
+import { formatKeyValue, formatDate, formatStatus, formatContentType, truncate } from "../formatter.js";
 // ============================================
 // Resource URIs
 // ============================================
@@ -39,7 +39,7 @@ export async function listBriefResources(context) {
             resources.push({
                 uri: `${BRIEF_URI_PREFIX}${brief.id}`,
                 name: truncate(brief.topic, 50),
-                description: `${formatStatus(brief.status)} - ${brief.content_type || "article"}`,
+                description: `${formatStatus(brief.status)} - ${formatContentType(brief.content_type)}`,
                 mimeType: "text/markdown",
             });
         }
@@ -79,7 +79,7 @@ async function readBriefsList(context) {
     markdown += `| Topic | Status | Type | Created |\n`;
     markdown += `|-------|--------|------|--------|\n`;
     for (const brief of response.data) {
-        markdown += `| ${truncate(brief.topic, 40)} | ${formatStatus(brief.status)} | ${brief.content_type || "-"} | ${formatDate(brief.created_at)} |\n`;
+        markdown += `| ${truncate(brief.topic, 40)} | ${formatStatus(brief.status)} | ${formatContentType(brief.content_type)} | ${formatDate(brief.created_at)} |\n`;
     }
     const { pagination } = response;
     markdown += `\n**Showing ${response.data.length} of ${pagination.total} items**\n`;
@@ -95,15 +95,21 @@ async function readBriefDetails(briefId, context) {
     markdown += formatKeyValue({
         ID: brief.id,
         Status: formatStatus(brief.status),
-        "Content Type": brief.content_type || "-",
+        "Content Type": formatContentType(brief.content_type),
         "Search Intent": brief.search_intent || "-",
         "Target Words": brief.target_word_count || "-",
         Created: formatDate(brief.created_at),
         Updated: brief.updated_at ? formatDate(brief.updated_at) : "-",
     });
-    if (brief.target_keywords && brief.target_keywords.length > 0) {
+    // Use original user-specified keywords if available (targetKeywords gets
+    // overwritten with expanded keywords during outline generation)
+    const originalKeywords = brief.progress_details?.originalKeywords;
+    const displayKeywords = (originalKeywords && originalKeywords.length > 0)
+        ? originalKeywords
+        : brief.target_keywords;
+    if (displayKeywords && displayKeywords.length > 0) {
         markdown += "\n## Target Keywords\n\n";
-        for (const keyword of brief.target_keywords) {
+        for (const keyword of displayKeywords) {
             markdown += `- ${keyword}\n`;
         }
     }

package/dist/resources/briefs.js.map

@@ -1 +1 @@
-{"version":3,"file":"briefs.js","sourceRoot":"","sources":["../../src/resources/briefs.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"briefs.js","sourceRoot":"","sources":["../../src/resources/briefs.ts"],"names":[],"mappings":"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"}

package/dist/tools/ai-visibility.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-visibility.d.ts","sourceRoot":"","sources":["../../src/tools/ai-visibility.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EACV,iBAAiB,EACjB,WAAW,EACX,UAAU,EAGX,MAAM,aAAa,CAAC;AAiIrB,eAAO,MAAM,mBAAmB,EAAE,iBAajC,CAAC;AAEF,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAiFrB;AAYD,eAAO,MAAM,eAAe,EAAE,iBAoB7B,CAAC;AAEF,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CA8CrB;AAeD,eAAO,MAAM,gBAAgB,EAAE,iBAoC9B,CAAC;AAEF,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAyCrB;AAUD,eAAO,MAAM,aAAa,EAAE,iBAa3B,CAAC;AAEF,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAiErB;AAcD,eAAO,MAAM,gBAAgB,EAAE,iBAiC9B,CAAC;AAEF,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAoCrB;AAYD,eAAO,MAAM,kBAAkB,EAAE,iBAoBhC,CAAC;AAEF,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAuDrB;AAWD,eAAO,MAAM,aAAa,EAAE,iBAgB3B,CAAC;AAEF,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAsDrB;AAYD,eAAO,MAAM,eAAe,EAAE,iBAoB7B,CAAC;AAEF,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAoErB;AAoBD,eAAO,MAAM,kBAAkB,EAAE,iBAqBhC,CAAC;AAEF,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAqDrB;AAMD,eAAO,MAAM,iBAAiB,EAAE,iBAAiB,EAUhD,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,MAAM,CACxC,MAAM,EACN,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,UAAU,CAAC,CAW9D,CAAC"}
+{"version":3,"file":"ai-visibility.d.ts","sourceRoot":"","sources":["../../src/tools/ai-visibility.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EACV,iBAAiB,EACjB,WAAW,EACX,UAAU,EAGX,MAAM,aAAa,CAAC;AAwIrB,eAAO,MAAM,mBAAmB,EAAE,iBAiBjC,CAAC;AAEF,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CA8GrB;AAYD,eAAO,MAAM,eAAe,EAAE,iBAoB7B,CAAC;AAEF,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CA8CrB;AAiBD,eAAO,MAAM,gBAAgB,EAAE,iBA8C9B,CAAC;AAEF,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CA8CrB;AAUD,eAAO,MAAM,aAAa,EAAE,iBAa3B,CAAC;AAEF,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAiErB;AAcD,eAAO,MAAM,gBAAgB,EAAE,iBAiC9B,CAAC;AAEF,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAoCrB;AAaD,eAAO,MAAM,kBAAkB,EAAE,iBAwBhC,CAAC;AAEF,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAwDrB;AAWD,eAAO,MAAM,aAAa,EAAE,iBAgB3B,CAAC;AAEF,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAsDrB;AAYD,eAAO,MAAM,eAAe,EAAE,iBAoB7B,CAAC;AAEF,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAoErB;AAoBD,eAAO,MAAM,kBAAkB,EAAE,iBAqBhC,CAAC;AAEF,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAqDrB;AAMD,eAAO,MAAM,iBAAiB,EAAE,iBAAiB,EAUhD,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,MAAM,CACxC,MAAM,EACN,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,UAAU,CAAC,CAW9D,CAAC"}

package/dist/tools/ai-visibility.js

@@ -11,10 +11,11 @@ import { formatTable, formatStatus, formatDate, formatPagination, formatKeyValue
 // ============================================
 const getAiVisibilityInputSchema = z.object({
     days: z.number().min(1).max(90).optional().default(30),
+    site_id: z.string().optional(),
 });
 export const getAiVisibilityTool = {
     name: "get_ai_visibility",
-    description: "Get an overview of your AI visibility metrics - how your content appears in AI search results like ChatGPT, Perplexity, etc.",
+    description: "Get an overview of your AI visibility metrics - how your content appears in AI search results like ChatGPT, Perplexity, etc. Use site_id to filter to a specific site (recommended), or omit for aggregated data across all sites.",
     inputSchema: {
         type: "object",
         properties: {
@@ -22,6 +23,10 @@ export const getAiVisibilityTool = {
                 type: "number",
                 description: "Number of days to look back (1-90, default: 30)",
             },
+            site_id: {
+                type: "string",
+                description: "Site ID for per-site metrics. Use list_sites to get available IDs. If omitted, returns aggregated data across all sites.",
+            },
         },
     },
 };
@@ -33,9 +38,11 @@ export async function executeGetAiVisibility(input, context) {
             markdown: `**Error:** Invalid input - ${parsed.error.message}`,
         };
     }
-    const { days } = parsed.data;
+    const { days, site_id } = parsed.data;
     try {
         const params = { days };
+        if (site_id)
+            params.site_id = site_id;
         const response = await context.client.get("/ai-visibility", params, CACHE_TTL.resources);
         const data = response.data;
         if (!data) {
@@ -46,14 +53,39 @@ export async function executeGetAiVisibility(input, context) {
             };
         }
         const overview = data.overview;
+        const overviewPrompts = data.prompts ?? [];
+        // Appearance rate: % of prompts where brand is visible (matches app definition)
+        const appearanceRate = overviewPrompts.length > 0
+            ? Math.round((overviewPrompts.filter((p) => p.is_visible).length / overviewPrompts.length) * 100)
+            : null;
+        // Citation rate: % of prompts where brand is cited
+        const citationRate = overviewPrompts.length > 0
+            ? Math.round((overviewPrompts.filter((p) => p.is_cited).length / overviewPrompts.length) * 100)
+            : null;
         let markdown = `## AI Visibility Overview (Last ${overview.period_days} days)\n\n`;
         markdown += formatKeyValue({
             total_prompts: overview.total_prompts ?? 0,
-            avg_visibility_score: overview.avg_visibility_score != null ? overview.avg_visibility_score.toString() : "N/A",
+            avg_visibility_score: overview.avg_visibility_score != null ? `${overview.avg_visibility_score}/100` : "N/A",
+            share_of_voice: overview.share_of_voice != null ? `${overview.share_of_voice}%` : "N/A (provide site_id for SOV)",
+            appearance_rate: appearanceRate != null ? `${appearanceRate}%` : "N/A",
+            citation_rate: citationRate != null ? `${citationRate}%` : "N/A",
             total_checks: overview.total_checks ?? 0,
             total_mentions: overview.total_mentions ?? 0,
             total_citations: overview.total_citations ?? 0,
         });
+        // Show competitor SOV breakdown if available
+        const competitorBreakdown = overview.competitor_breakdown ?? [];
+        if (competitorBreakdown.length > 0) {
+            markdown += "\n\n### Share of Voice Breakdown\n\n";
+            const sovHeaders = ["Competitor", "Mentions", "SOV"];
+            const sovRows = competitorBreakdown.map((c) => [
+                c.name,
+                c.mentions.toString(),
+                `${c.sov}%`,
+            ]);
+            markdown += formatTable(sovHeaders, sovRows);
+        }
+        markdown += `\n\n> **Tip:** Use \`list_prompts\` and \`get_prompt\` for detailed per-prompt metrics.`;
         const platforms = data.platform_breakdown ?? [];
         if (platforms.length > 0) {
             markdown += "\n\n### Platform Breakdown\n\n";
@@ -170,8 +202,10 @@ const createPromptInputSchema = z.object({
     prompt_text: z.string().min(10).max(1000),
     target_brand: z.string().min(1).max(255),
     brand_variants: z.array(z.string()).optional(),
-    frequency: z.enum(["daily", "weekly", "manual"]).optional().default("daily"),
+    frequency: z.enum(["daily", "weekly"]).optional().default("daily"),
     platforms: z.array(z.string()).optional(),
+    category: z.enum(["brand", "competitors", "product", "problem", "commercial", "custom"]).optional().default("product"),
+    location: z.enum(["global", "us", "uk", "eu", "apac", "latam"]).optional().default("global"),
     site_id: z.string().optional(),
 });
 export const createPromptTool = {
@@ -195,7 +229,7 @@ export const createPromptTool = {
             },
             frequency: {
                 type: "string",
-                enum: ["daily", "weekly", "manual"],
+                enum: ["daily", "weekly"],
                 description: "How often to crawl this prompt (default: daily)",
             },
             platforms: {
@@ -203,9 +237,19 @@ export const createPromptTool = {
                 items: { type: "string" },
                 description: "AI platforms to track (e.g., chatgpt, perplexity, claude, gemini, google_ai, grok, copilot, deepseek)",
             },
+            category: {
+                type: "string",
+                enum: ["brand", "competitors", "product", "problem", "commercial", "custom"],
+                description: "Prompt category (default: product)",
+            },
+            location: {
+                type: "string",
+                enum: ["global", "us", "uk", "eu", "apac", "latam"],
+                description: "Geographic location for tracking (default: global)",
+            },
             site_id: {
                 type: "string",
-                description: "Associate with a specific site",
+                description: "Associate with a specific site (strongly recommended — prompts without a site_id will NOT appear in the Frase app). Use list_sites to get available IDs.",
             },
         },
         required: ["prompt_text", "target_brand"],
@@ -219,9 +263,9 @@ export async function executeCreatePrompt(input, context) {
             markdown: `**Error:** Invalid input - ${parsed.error.message}`,
         };
     }
-    const { prompt_text, target_brand, brand_variants, frequency, platforms, site_id } = parsed.data;
+    const { prompt_text, target_brand, brand_variants, frequency, platforms, category, location, site_id } = parsed.data;
     try {
-        const body = { prompt_text, target_brand, frequency };
+        const body = { prompt_text, target_brand, frequency, category, location };
         if (brand_variants)
             body.brand_variants = brand_variants;
         if (platforms)
@@ -235,9 +279,13 @@ export async function executeCreatePrompt(input, context) {
             prompt_text: prompt.prompt_text,
             status: prompt.status,
         });
+        let markdown = `## Prompt Created\n\n${details}\n\n**Note:** The prompt will be crawled automatically. Use \`get_prompt\` to see results.`;
+        if (!site_id) {
+            markdown += `\n\n> **Warning:** No site_id was provided. This prompt may not appear in site-scoped views in the Frase app. Recreate the prompt with a site_id to ensure visibility.`;
+        }
         return {
             success: true,
-            markdown: `## Prompt Created\n\n${details}\n\n**Note:** The prompt will be crawled automatically. Use \`get_prompt\` to see results.`,
+            markdown,
             data: response,
         };
     }
@@ -331,7 +379,7 @@ export async function executeGetPrompt(input, context) {
 const updatePromptInputSchema = z.object({
     id: z.string().min(1),
     status: z.enum(["active", "paused", "archived"]).optional(),
-    frequency: z.enum(["daily", "weekly", "manual"]).optional(),
+    frequency: z.enum(["daily", "weekly"]).optional(),
     platforms: z.array(z.string()).optional(),
     brand_variants: z.array(z.string()).optional(),
 });
@@ -352,7 +400,7 @@ export const updatePromptTool = {
             },
             frequency: {
                 type: "string",
-                enum: ["daily", "weekly", "manual"],
+                enum: ["daily", "weekly"],
                 description: "How often to crawl this prompt",
             },
             platforms: {
@@ -407,6 +455,7 @@ const getCompetitorsInputSchema = z.object({
     page: z.number().min(1).optional().default(1),
     page_size: z.number().min(1).max(100).optional().default(20),
     days: z.number().min(1).max(90).optional().default(30),
+    site_id: z.string().optional(),
 });
 export const getCompetitorsTool = {
     name: "get_competitors",
@@ -426,6 +475,10 @@ export const getCompetitorsTool = {
                 type: "number",
                 description: "Number of days to look back (1-90, default: 30)",
             },
+            site_id: {
+                type: "string",
+                description: "Filter competitors by site ID. Use list_sites to get available IDs.",
+            },
         },
     },
 };
@@ -437,9 +490,11 @@ export async function executeGetCompetitors(input, context) {
             markdown: `**Error:** Invalid input - ${parsed.error.message}`,
         };
     }
-    const { page, page_size, days } = parsed.data;
+    const { page, page_size, days, site_id } = parsed.data;
     try {
         const params = { page, page_size, days };
+        if (site_id)
+            params.site_id = site_id;
         const response = await context.client.get("/ai-visibility/competitors", params, CACHE_TTL.resources);
         const competitors = Array.isArray(response.data) ? response.data : [];
         if (competitors.length === 0) {