@kandleconsultinggroup/agent-seo 0.1.0

package/README.md

@@ -0,0 +1,41 @@
+# @kandle/agent-seo
+
+SEO blog writing agent for Kandle.
+
+## Installation
+
+```bash
+npm install @kandle/agent-seo @kandle/core
+```
+
+## Usage
+
+```javascript
+const { Kandle } = require("@kandle/core");
+const seoAgent = require("@kandle/agent-seo");
+
+const kandle = new Kandle({
+  agents: [seoAgent],
+  storage: /* your storage */,
+});
+
+const task = await kandle.createTask("seo", {
+  topic: "How AI is Transforming Business",
+});
+
+const { artifacts } = await kandle.runTask(task);
+```
+
+## Configuration
+
+Task input options:
+
+- `topic` - Blog post topic (optional, has default)
+- `keywords` - SEO keywords array (optional)
+- `tone` - Writing tone (optional)
+- `audience` - Target audience (optional)
+- `length` - Target word count (optional)
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@kandleconsultinggroup/agent-seo",
+  "version": "0.1.0",
+  "description": "SEO blog writing agent for Kandle",
+  "main": "src/index.js",
+  "type": "commonjs",
+  "scripts": {
+    "test": "echo \"no tests yet\"",
+    "dev": "node src/dev.js"
+  },
+  "author": "Kandle Consulting Group",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/your-username/kandle.git",
+    "directory": "kandle-agent-seo"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "src",
+    "README.md"
+  ],
+  "dependencies": {
+    "@kandleconsultinggroup/core": "^0.1.0",
+    "dotenv": "^17.2.3"
+  }
+}

package/src/SEOAgent.js

@@ -0,0 +1,57 @@
+const { Agent, OpenAIClient } = require("@kandleconsultinggroup/core");
+const writeBlogPrompt = require("./prompts/writeBlog");
+const reviseBlogPrompt = require("./prompts/reviseBlog");
+
+const openai = new OpenAIClient();
+
+class SEOAgent extends Agent {
+  async execute(task) {
+    const {
+      topic = "How SMBs Can Use Cloud Software Effectively",
+      keywords = [],
+      tone = "professional and approachable",
+      audience = "small business owners",
+      length = 1200,
+    } = this.config;
+
+    const prompt = writeBlogPrompt({
+      topic,
+      keywords,
+      tone,
+      audience,
+      length,
+    });
+
+    const content = await openai.generate({ prompt, maxTokens: 2000 });
+
+    return [
+      {
+        type: "blog_post",
+        content,
+        metadata: {
+          topic,
+          keywords,
+          wordTarget: length,
+        },
+      },
+    ];
+  }
+
+  async revise(task, feedback) {
+    const originalArtifactContent = task.metadata?.originalContent;
+
+    const prompt = reviseBlogPrompt({
+      content: originalArtifactContent,
+      feedback,
+    });
+
+    const revisedContent = await openai.generate({ prompt, maxTokens: 2000 });
+
+    return {
+      type: "blog_post",
+      content: revisedContent,
+    };
+  }
+}
+
+module.exports = SEOAgent;

package/src/dev.js

@@ -0,0 +1,18 @@
+const { Kandle, MemoryAdapter } = require("@kandleconsultinggroup/core");
+const seoAgent = require("@kandleconsultinggroup/agent-seo");
+
+(async () => {
+  const kandle = new Kandle({
+    storage: new MemoryAdapter(),
+    agents: [seoAgent],
+    seo: {
+      keywords: ["cloud consulting", "SMB software"],
+      tone: "friendly and practical",
+    },
+  });
+
+  const task = await kandle.createTask("seo", {});
+  const result = await kandle.runTask(task);
+
+  console.log(result.artifacts[0]);
+})();

package/src/index.js

@@ -0,0 +1,6 @@
+const SEOAgent = require("./SEOAgent");
+
+module.exports = {
+  type: "seo",
+  agent: SEOAgent,
+};

package/src/prompts/reviseBlog.js

@@ -0,0 +1,14 @@
+module.exports = function reviseBlogPrompt({ content, feedback }) {
+  return `
+You are revising an existing blog post.
+
+Original content:
+${content}
+
+Revision feedback:
+${feedback}
+
+Revise the post accordingly while preserving structure and SEO quality.
+Return ONLY the revised content.
+`;
+};

package/src/prompts/writeBlog.js

@@ -0,0 +1,26 @@
+module.exports = function writeBlogPrompt({
+  topic,
+  keywords,
+  tone,
+  audience,
+  length,
+}) {
+  return `
+You are an expert SEO content writer.
+
+Write a long-form blog post with the following requirements:
+- Topic: ${topic}
+- Target keywords: ${keywords.join(", ")}
+- Tone: ${tone}
+- Audience: ${audience}
+- Length: ${length} words
+
+Structure the post with:
+- Clear H1 title
+- H2 and H3 subheadings
+- Practical examples
+- A short conclusion
+
+Return ONLY the blog content.
+`;
+};