@frase/mcp-server 0.2.1 → 0.3.2

package/dist/prompts/geo-optimization.js

@@ -0,0 +1,79 @@
+/**
+ * GEO Optimization Prompt
+ *
+ * Optimize content for AI engine citation (GEO/AEO).
+ * Analyzes content quotability, structures for AI extraction,
+ * and tracks before/after AI visibility changes.
+ */
+export const geoOptimizationPrompt = {
+    name: "geo_optimization",
+    description: "Optimize content for AI engine citation (GEO/AEO). Analyzes quotability, restructures content for AI extraction, and tracks visibility changes across ChatGPT, Perplexity, Claude, Google AI Overviews, Copilot, Grok, DeepSeek, and Gemini.",
+    arguments: [
+        {
+            name: "content_id",
+            description: "Content ID to optimize for GEO (required)",
+            required: true,
+        },
+        {
+            name: "site_id",
+            description: "Site ID for AI visibility tracking (required)",
+            required: true,
+        },
+        {
+            name: "target_brand",
+            description: "Brand name to track in AI citations (required)",
+            required: true,
+        },
+    ],
+};
+export function getGeoOptimizationMessages(args) {
+    const contentId = args.content_id || "";
+    const siteId = args.site_id || "";
+    const targetBrand = args.target_brand || "";
+    return [
+        {
+            role: "user",
+            content: {
+                type: "text",
+                text: `Optimize content "${contentId}" for AI engine citation (GEO/AEO). Make it quotable by ChatGPT, Perplexity, Claude, Google AI Overviews, Copilot, Grok, DeepSeek, and Gemini.
+
+**Configuration:**
+- Content ID: ${contentId}
+- Site ID: ${siteId}
+- Brand: ${targetBrand}
+
+**Execute these steps:**
+
+**Step 1 — Baseline AI Visibility:** Use get_ai_visibility with site_id "${siteId}" to get current visibility metrics. Note which platforms currently cite this content and which don't.
+
+**Step 2 — Get Content:** Use get_content with content_id "${contentId}" to review the current content structure.
+
+**Step 3 — Run Optimization:** Use start_optimization with content_id "${contentId}". Wait for completion using get_job_status, then use get_optimization to review both SEO and GEO scores and suggestions.
+
+**Step 4 — Apply GEO-Specific Improvements:** Focus on suggestions that improve AI quotability:
+- Add structured claims with citations (e.g., "According to [source], X increases Y by Z%")
+- Include statistics and data points with sources
+- Write clear, quotable one-sentence statements
+- Add FAQ sections with concise 2-3 sentence answers
+- Use clear H2/H3 headings that match common queries
+- Add comparison tables for "vs" queries
+- Include a summary/TL;DR section
+Apply high-priority suggestions using apply_optimization.
+
+**Step 5 — Re-Score:** Use start_optimization again to verify the GEO score improved. Target GEO score >= 70. Repeat optimization up to 2 more times if below target.
+
+**Step 6 — Set Up Monitoring:** Use create_prompt with a natural question about this content's topic and target_brand "${targetBrand}". This tracks future AI citations.
+
+**Step 7 — Check AI Insights:** Use get_insights for actionable recommendations and get_competitors to see who currently gets cited for related queries.
+
+**Provide a summary report:**
+- Before/after GEO score
+- Key GEO improvements applied
+- Citation gap diagnosis (content, authority, entity, or citation gap)
+- AI visibility monitoring status
+- Recommended next steps`,
+            },
+        },
+    ];
+}
+//# sourceMappingURL=geo-optimization.js.map

package/dist/prompts/geo-optimization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geo-optimization.js","sourceRoot":"","sources":["../../src/prompts/geo-optimization.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,CAAC,MAAM,qBAAqB,GAAwB;IACxD,IAAI,EAAE,kBAAkB;IACxB,WAAW,EACT,8OAA8O;IAChP,SAAS,EAAE;QACT;YACE,IAAI,EAAE,YAAY;YAClB,WAAW,EAAE,2CAA2C;YACxD,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,+CAA+C;YAC5D,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,cAAc;YACpB,WAAW,EAAE,gDAAgD;YAC7D,QAAQ,EAAE,IAAI;SACf;KACF;CACF,CAAC;AAEF,MAAM,UAAU,0BAA0B,CAAC,IAA4B;IAIrE,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC;IACxC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;IAClC,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC;IAE5C,OAAO;QACL;YACE,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE;gBACP,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,qBAAqB,SAAS;;;gBAG5B,SAAS;aACZ,MAAM;WACR,WAAW;;;;2EAIqD,MAAM;;6DAEpB,SAAS;;yEAEG,SAAS;;;;;;;;;;;;;;yHAcuC,WAAW;;;;;;;;;yBAS3G;aAClB;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/prompts/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AA0CvD,eAAO,MAAM,WAAW,EAAE,mBAAmB,EAQ5C,CAAC;AAyBF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAE7E;AAMD,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC3B,KAAK,CAAC;IACP,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACzC,CAAC,CAOD;AAMD,wBAAgB,cAAc,IAAI,MAAM,CAEvC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AA+DvD,eAAO,MAAM,WAAW,EAAE,mBAAmB,EAc5C,CAAC;AA+BF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAE7E;AAMD,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC3B,KAAK,CAAC;IACP,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACzC,CAAC,CAOD;AAMD,wBAAgB,cAAc,IAAI,MAAM,CAEvC"}

package/dist/prompts/index.js

@@ -12,6 +12,11 @@ import { competitorAnalysisPrompt, getCompetitorAnalysisMessages, } from "./comp
 import { contentAuditPrompt, getContentAuditMessages, } from "./content-audit.js";
 import { contentPipelinePrompt, getContentPipelineMessages, } from "./content-pipeline.js";
 import { contentWatchdogPrompt, getContentWatchdogMessages, } from "./content-watchdog.js";
+// New prompts (GEO/AEO, Competitive, Governance, Publishing)
+import { geoOptimizationPrompt, getGeoOptimizationMessages, } from "./geo-optimization.js";
+import { competitiveIntelligencePrompt, getCompetitiveIntelligenceMessages, } from "./competitive-intelligence.js";
+import { contentGovernancePrompt, getContentGovernanceMessages, } from "./content-governance.js";
+import { cmsPublishingPrompt, getCmsPublishingMessages, } from "./cms-publishing.js";
 // ============================================
 // All Prompts
 // ============================================
@@ -23,6 +28,11 @@ export const ALL_PROMPTS = [
     contentAuditPrompt,
     contentPipelinePrompt,
     contentWatchdogPrompt,
+    // New prompts
+    geoOptimizationPrompt,
+    competitiveIntelligencePrompt,
+    contentGovernancePrompt,
+    cmsPublishingPrompt,
 ];
 const PROMPT_MESSAGE_GENERATORS = {
     create_seo_article: getCreateSeoArticleMessages,
@@ -32,6 +42,11 @@ const PROMPT_MESSAGE_GENERATORS = {
     content_audit: getContentAuditMessages,
     content_pipeline: getContentPipelineMessages,
     content_watchdog: getContentWatchdogMessages,
+    // New prompts
+    geo_optimization: getGeoOptimizationMessages,
+    competitive_intelligence: getCompetitiveIntelligenceMessages,
+    content_governance: getContentGovernanceMessages,
+    cms_publishing: getCmsPublishingMessages,
 };
 // ============================================
 // Get Prompt by Name

package/dist/prompts/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,wBAAwB;AACxB,OAAO,EACL,sBAAsB,EACtB,2BAA2B,GAC5B,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,wBAAwB,EACxB,6BAA6B,GAC9B,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,uBAAuB,CAAC;AAE/B,+CAA+C;AAC/C,cAAc;AACd,+CAA+C;AAE/C,MAAM,CAAC,MAAM,WAAW,GAA0B;IAChD,sBAAsB;IACtB,qBAAqB;IACrB,qBAAqB;IACrB,wBAAwB;IACxB,kBAAkB;IAClB,qBAAqB;IACrB,qBAAqB;CACtB,CAAC;AAWF,MAAM,yBAAyB,GAA2C;IACxE,kBAAkB,EAAE,2BAA2B;IAC/C,gBAAgB,EAAE,0BAA0B;IAC5C,gBAAgB,EAAE,0BAA0B;IAC5C,mBAAmB,EAAE,6BAA6B;IAClD,aAAa,EAAE,uBAAuB;IACtC,gBAAgB,EAAE,0BAA0B;IAC5C,gBAAgB,EAAE,0BAA0B;CAC7C,CAAC;AAEF,+CAA+C;AAC/C,qBAAqB;AACrB,+CAA+C;AAE/C,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AAClD,CAAC;AAED,+CAA+C;AAC/C,sBAAsB;AACtB,+CAA+C;AAE/C,MAAM,UAAU,iBAAiB,CAC/B,IAAY,EACZ,IAA4B;IAK5B,MAAM,SAAS,GAAG,yBAAyB,CAAC,IAAI,CAAC,CAAC;IAClD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC;AAED,+CAA+C;AAC/C,mBAAmB;AACnB,+CAA+C;AAE/C,MAAM,UAAU,cAAc;IAC5B,OAAO,WAAW,CAAC,MAAM,CAAC;AAC5B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,wBAAwB;AACxB,OAAO,EACL,sBAAsB,EACtB,2BAA2B,GAC5B,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,wBAAwB,EACxB,6BAA6B,GAC9B,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,uBAAuB,CAAC;AAE/B,6DAA6D;AAC7D,OAAO,EACL,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,6BAA6B,EAC7B,kCAAkC,GACnC,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACL,uBAAuB,EACvB,4BAA4B,GAC7B,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,qBAAqB,CAAC;AAE7B,+CAA+C;AAC/C,cAAc;AACd,+CAA+C;AAE/C,MAAM,CAAC,MAAM,WAAW,GAA0B;IAChD,sBAAsB;IACtB,qBAAqB;IACrB,qBAAqB;IACrB,wBAAwB;IACxB,kBAAkB;IAClB,qBAAqB;IACrB,qBAAqB;IAErB,cAAc;IACd,qBAAqB;IACrB,6BAA6B;IAC7B,uBAAuB;IACvB,mBAAmB;CACpB,CAAC;AAWF,MAAM,yBAAyB,GAA2C;IACxE,kBAAkB,EAAE,2BAA2B;IAC/C,gBAAgB,EAAE,0BAA0B;IAC5C,gBAAgB,EAAE,0BAA0B;IAC5C,mBAAmB,EAAE,6BAA6B;IAClD,aAAa,EAAE,uBAAuB;IACtC,gBAAgB,EAAE,0BAA0B;IAC5C,gBAAgB,EAAE,0BAA0B;IAE5C,cAAc;IACd,gBAAgB,EAAE,0BAA0B;IAC5C,wBAAwB,EAAE,kCAAkC;IAC5D,kBAAkB,EAAE,4BAA4B;IAChD,cAAc,EAAE,wBAAwB;CACzC,CAAC;AAEF,+CAA+C;AAC/C,qBAAqB;AACrB,+CAA+C;AAE/C,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AAClD,CAAC;AAED,+CAA+C;AAC/C,sBAAsB;AACtB,+CAA+C;AAE/C,MAAM,UAAU,iBAAiB,CAC/B,IAAY,EACZ,IAA4B;IAK5B,MAAM,SAAS,GAAG,yBAAyB,CAAC,IAAI,CAAC,CAAC;IAClD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC;AAED,+CAA+C;AAC/C,mBAAmB;AACnB,+CAA+C;AAE/C,MAAM,UAAU,cAAc;IAC5B,OAAO,WAAW,CAAC,MAAM,CAAC;AAC5B,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) {