nod-shout 0.1.0

package/save-jeffries-shout.ts

@@ -0,0 +1,38 @@
+import { createClient } from '@supabase/supabase-js';
+import { readFileSync } from 'fs';
+import { extractMetadata } from './src/lib/metadata.js';
+import { generateSummary } from './src/lib/ai.js';
+
+async function main() {
+  const env = Object.fromEntries(
+    readFileSync('.env', 'utf8').split('\n').filter(l => l.includes('=')).map(l => {
+      const [k, ...v] = l.split('=');
+      return [k.trim(), v.join('=').trim()];
+    })
+  );
+  process.env.OPENAI_API_KEY = env.OPENAI_API_KEY;
+  const supabase = createClient(env.SUPABASE_URL, env.SUPABASE_SERVICE_ROLE_KEY);
+  const { data: profile } = await supabase.from('profiles').select('id').eq('username', 'fubz').single();
+  if (!profile) throw new Error('profile not found');
+
+  const url = 'https://x.com/Dan_Jeffries1/status/2034916790711538061';
+  
+  // tweet metadata - we have the full text already
+  const title = 'Dan Jeffries: OpenClaw is a Napster moment, not a DeepSeek moment';
+  const description = 'dan jeffries argues openclaw is the napster of software — it forces vendors to open up API access for agents or get routed around. just like napster forced the music industry to build itunes and spotify, openclaw hacks around locked-down platforms (whatsapp, google ads, etc) to give people the unified agent access vendors refuse to provide.';
+  const summary = description;
+  const image_url = null;
+  const tags = ['ai-agents', 'openclaw', 'open-source', 'platform-access', 'napster-analogy'];
+  const category = 'ai';
+
+  const { data, error } = await supabase.from('shouts').insert({
+    user_id: profile.id, url, title, description,
+    summary, user_take: null, image_url,
+    tags, category, collection_id: null,
+    source: 'conversation', visibility: 'public',
+  }).select('id,title,summary,tags,category').single();
+
+  if (error) throw error;
+  console.log(JSON.stringify(data, null, 2));
+}
+main().catch(e => { console.error(e); process.exit(1); });

package/save-openai-shout.ts

@@ -0,0 +1,35 @@
+import { createClient } from '@supabase/supabase-js';
+import { readFileSync } from 'fs';
+import { extractMetadata } from './src/lib/metadata.js';
+import { generateSummary } from './src/lib/ai.js';
+
+async function main() {
+  const env = Object.fromEntries(
+    readFileSync('.env', 'utf8').split('\n').filter(l => l.includes('=')).map(l => {
+      const [k, ...v] = l.split('=');
+      return [k.trim(), v.join('=').trim()];
+    })
+  );
+  process.env.OPENAI_API_KEY = env.OPENAI_API_KEY;
+  const supabase = createClient(env.SUPABASE_URL, env.SUPABASE_SERVICE_ROLE_KEY);
+  const { data: profile } = await supabase.from('profiles').select('id').eq('username', 'fubz').single();
+  if (!profile) throw new Error('profile not found');
+
+  const url = 'https://openai.com/index/introducing-gpt-5-4-mini-and-nano/';
+  const metadata = await extractMetadata(url);
+  const aiResult = await generateSummary({
+    url, title: metadata.title, description: metadata.description,
+    bodyText: metadata.bodyText, userContext: null,
+  });
+
+  const { data, error } = await supabase.from('shouts').insert({
+    user_id: profile.id, url, title: metadata.title, description: metadata.description,
+    summary: aiResult.summary, user_take: null, image_url: metadata.image_url,
+    tags: aiResult.tags, category: aiResult.category, collection_id: null,
+    source: 'conversation', visibility: 'public',
+  }).select('id,title,summary,tags,category').single();
+
+  if (error) throw error;
+  console.log(JSON.stringify(data, null, 2));
+}
+main().catch(e => { console.error(e); process.exit(1); });

package/save-prcarly.ts

@@ -0,0 +1,46 @@
+import { extractMetadata } from './src/lib/metadata.js';
+import { generateSummary } from './src/lib/ai.js';
+import { createClient } from '@supabase/supabase-js';
+import { readFileSync } from 'fs';
+
+const env = Object.fromEntries(
+  readFileSync('.env', 'utf8').split('\n').filter(l => l.includes('=')).map(l => {
+    const [k, ...v] = l.split('=');
+    return [k.trim(), v.join('=').trim()];
+  })
+);
+process.env.OPENAI_API_KEY = env.OPENAI_API_KEY;
+const sb = createClient(env.SUPABASE_URL, env.SUPABASE_SERVICE_ROLE_KEY);
+
+async function main() {
+  const { data: profile } = await sb.from('profiles').select('id').eq('username', 'fubz').single();
+  if (!profile) throw new Error('no profile');
+
+  const url = 'https://x.com/PRcarly/status/2034281879265018059';
+  const ai = await generateSummary({
+    url,
+    title: 'PR strategy got a trademark attorney on Google News above USA Today',
+    description: '311 earned media placements in 18 months from one repeatable strategy: spot news early, pitch expert commentary first.',
+    bodyText: 'Trademark attorney Josh Gerben built 311 earned media placements in 18 months from one strategy: spot trademark filings early, pitch expert commentary before anyone else. PR became his only marketing channel. His blog now appears in Google News above USA Today. Google algorithm looks for expertise, authority, trustworthiness. When 311 articles from major news outlets point back to the same domain, that is an overwhelming authority signal.',
+    userContext: 'Jeff shared this as a playbook for HypeLab/OCA and Remitian PR strategies',
+  });
+
+  const { data, error } = await sb.from('shouts').insert({
+    user_id: profile.id,
+    url,
+    title: 'PR strategy got a trademark attorney on Google News above USA Today',
+    description: '311 earned media placements in 18 months from one repeatable strategy.',
+    summary: ai.summary,
+    user_take: 'Direct playbook for what we are doing with HypeLab/OCA (AI agent news commentary) and Remitian (tax payment regulatory commentary). Same structure: expert spots news early, pitches take, domain authority compounds.',
+    image_url: 'https://pbs.twimg.com/media/HDs4loIawAEZfII.jpg',
+    tags: ai.tags,
+    category: ai.category || 'growth',
+    collection_id: '233be2f1-e79a-4d4b-aea4-e8c6b0e6dc1e',
+    source: 'conversation',
+    visibility: 'public',
+  }).select('id,title').single();
+
+  console.log(error ? error.message : 'Saved: ' + data.title);
+}
+
+main();

package/save-shout.ts

@@ -0,0 +1,35 @@
+import { createClient } from '@supabase/supabase-js';
+import { readFileSync } from 'fs';
+import { extractMetadata } from './src/lib/metadata.js';
+import { generateSummary } from './src/lib/ai.js';
+
+async function main() {
+  const env = Object.fromEntries(
+    readFileSync('.env', 'utf8').split('\n').filter(l => l.includes('=')).map(l => {
+      const [k, ...v] = l.split('=');
+      return [k.trim(), v.join('=').trim()];
+    })
+  );
+  process.env.OPENAI_API_KEY = env.OPENAI_API_KEY;
+  const supabase = createClient(env.SUPABASE_URL, env.SUPABASE_SERVICE_ROLE_KEY);
+  const { data: profile } = await supabase.from('profiles').select('id').eq('username', 'fubz').single();
+  if (!profile) throw new Error('profile not found');
+
+  const url = 'https://techcrunch.com/2026/03/16/merriam-webster-openai-encyclopedia-brittanica-lawsuit/';
+  const metadata = await extractMetadata(url);
+  const aiResult = await generateSummary({
+    url, title: metadata.title, description: metadata.description,
+    bodyText: metadata.bodyText, userContext: null,
+  });
+
+  const { data, error } = await supabase.from('shouts').insert({
+    user_id: profile.id, url, title: metadata.title, description: metadata.description,
+    summary: aiResult.summary, user_take: null, image_url: metadata.image_url,
+    tags: aiResult.tags, category: aiResult.category, collection_id: null,
+    source: 'conversation', visibility: 'public',
+  }).select('id,title,summary,tags,category').single();
+
+  if (error) throw error;
+  console.log(JSON.stringify(data, null, 2));
+}
+main().catch(e => { console.error(e); process.exit(1); });

package/save-techcrunch-shout.ts

@@ -0,0 +1,59 @@
+import { createClient } from '@supabase/supabase-js';
+import { readFileSync } from 'fs';
+import { extractMetadata } from './src/lib/metadata.js';
+import { generateSummary } from './src/lib/ai.js';
+
+async function main() {
+  const env = Object.fromEntries(
+    readFileSync('.env', 'utf8').split('\n').filter(l => l.includes('=')).map(l => {
+      const [k, ...v] = l.split('=');
+      return [k.trim(), v.join('=').trim()];
+    })
+  );
+
+  process.env.OPENAI_API_KEY = env.OPENAI_API_KEY;
+
+  const supabase = createClient(env.SUPABASE_URL, env.SUPABASE_SERVICE_ROLE_KEY);
+  const username = 'fubz';
+  const url = 'https://techcrunch.com/2026/03/17/buzzfeed-ai-slop-apps-sxsw-bf-island-conjure/';
+  const take = 'hilarious and brutal. the apps sound terrible, and the review does not let them off easy.';
+
+  const { data: profile } = await supabase.from('profiles').select('id').eq('username', username).single();
+  if (!profile) throw new Error('profile not found');
+
+  const metadata = await extractMetadata(url);
+  const aiResult = await generateSummary({
+    url,
+    title: metadata.title,
+    description: metadata.description,
+    bodyText: metadata.bodyText,
+    userContext: take,
+  });
+
+  const { data, error } = await supabase
+    .from('shouts')
+    .insert({
+      user_id: profile.id,
+      url,
+      title: metadata.title,
+      description: metadata.description,
+      summary: aiResult.summary,
+      user_take: take,
+      image_url: metadata.image_url,
+      tags: aiResult.tags,
+      category: aiResult.category,
+      collection_id: null,
+      source: 'conversation',
+      visibility: 'public',
+    })
+    .select('id,title,summary,tags,category')
+    .single();
+
+  if (error) throw error;
+  console.log(JSON.stringify({ metadata, aiResult, saved: data }, null, 2));
+}
+
+main().catch((err) => {
+  console.error(err);
+  process.exit(1);
+});

package/save-zdnet-shout.ts

@@ -0,0 +1,36 @@
+import { createClient } from '@supabase/supabase-js';
+import { readFileSync } from 'fs';
+import { extractMetadata } from './src/lib/metadata.js';
+import { generateSummary } from './src/lib/ai.js';
+
+async function main() {
+  const env = Object.fromEntries(
+    readFileSync('.env', 'utf8').split('\n').filter(l => l.includes('=')).map(l => {
+      const [k, ...v] = l.split('=');
+      return [k.trim(), v.join('=').trim()];
+    })
+  );
+  process.env.OPENAI_API_KEY = env.OPENAI_API_KEY;
+  const supabase = createClient(env.SUPABASE_URL, env.SUPABASE_SERVICE_ROLE_KEY);
+
+  const { data: profile } = await supabase.from('profiles').select('id').eq('username', 'fubz').single();
+  if (!profile) throw new Error('profile not found');
+
+  const url = 'https://www.zdnet.com/article/gpt-5-4-mini-and-nano/';
+  const metadata = await extractMetadata(url);
+  const aiResult = await generateSummary({
+    url, title: metadata.title, description: metadata.description,
+    bodyText: metadata.bodyText, userContext: null,
+  });
+
+  const { data, error } = await supabase.from('shouts').insert({
+    user_id: profile.id, url, title: metadata.title, description: metadata.description,
+    summary: aiResult.summary, user_take: null, image_url: metadata.image_url,
+    tags: aiResult.tags, category: aiResult.category, collection_id: null,
+    source: 'conversation', visibility: 'public',
+  }).select('id,title,summary,tags,category').single();
+
+  if (error) throw error;
+  console.log(JSON.stringify(data, null, 2));
+}
+main().catch(e => { console.error(e); process.exit(1); });

package/skills/collection-routing/SKILL.md

@@ -0,0 +1,34 @@
+---
+name: collection-routing
+description: Use when deciding which collection a nod link belongs in. Helps map summaries and tags to stable collection intents.
+---
+
+# Collection Routing
+
+Goal: make links easier to file into the right collection.
+
+## Routing principles
+
+- Think in terms of the link's main use, not every topic it mentions.
+- Prefer the narrowest good fit.
+- Do not spray broad tags just to increase match rate.
+- If a link is mainly a tool or repo, prefer devtools over ai.
+- If a link is mainly a protocol, spec, or agent system, prefer agents.
+- If a link is mainly about exploits, prompt injection, auth, or abuse, prefer security.
+- If a link is mainly about ad strategy, SEO, GEO, AEO, or distribution, prefer marketing.
+- If a link is mainly about social products, messaging, creator tools, or community apps, prefer social.
+
+## Common routing examples
+
+- MCP, A2A, agents.json, JSON agents, agent manifests, agent skills -> agents
+- Claude Code tools, SDKs, CLIs, IDE integrations, GitHub repos -> devtools
+- Prompt injection, jailbreaks, auth issues, exploits -> security
+- GEO/AEO/SEO, ads, funnels, growth loops -> marketing
+- Group chat, feeds, audio rooms, creator/community products -> social
+- Pricing, SaaS margins, revenue, markets -> startups or finance depending on emphasis
+
+## Output behavior
+
+- Tags should support routing.
+- Category should reflect the primary route.
+- When in doubt, choose one strong route and keep the rest in tags.

package/skills/link-summary/SKILL.md

@@ -0,0 +1,53 @@
+---
+name: link-summary
+description: Use when summarizing a saved link for nod shout pages. Writes a short, specific preview that helps someone decide whether to click.
+---
+
+# Link Summary
+
+Goal: write a short summary that gives the reader a taste of the link before they click.
+
+## Output rules
+
+- Write 2 short sentences.
+- Sentence 1: say what the thing is or what happened.
+- Sentence 2: give a reason to click or a key detail.
+- If the page includes a concrete claim, number, company, feature, or person, include it.
+- Use plain English. Write like you're texting a friend.
+- Prefer direct nouns and verbs over adjectives.
+- Keep it under 240 characters when possible.
+
+## Banned openings and phrases
+
+Never start a summary with:
+- "this article discusses"
+- "this post is about"
+- "the page explains"
+- "the post discusses"
+- "X tweeted that"
+- "post by"
+- "page"
+- "clicking gives"
+- "clicking provides"
+- "clicking reveals"
+
+Never use:
+- "not just X but Y" or "isn't just X"
+- "thought-provoking", "must-read", "fascinating", "interesting", "insightful"
+- generic praise or vague claims about innovation or the future
+- marketing tone
+
+## Good examples
+
+- "Jeff Bezos calls AI a horizontal layer like electricity. Companies should treat it as core infrastructure, not a side feature."
+- "Menu bar app for tracking Codex and Claude Code usage stats. Shows supported providers and how limits work."
+- "Simon Willison breaks down prompt injection risks in MCP-style systems. Concrete examples of where tool-using agents can be tricked."
+- "Claude now supports live stock quotes and options chains in chat. Shows what data is available and how to wire it up."
+
+## Bad examples
+
+- "A fascinating look at the evolving AI landscape."
+- "This article provides insight into the future of business and technology."
+- "A must-read for anyone interested in AI."
+- "Post by Jeff Bezos defines AI as a horizontal enabling layer. Clicking reveals his argument."
+- "The page explains how agent discovery works in the protocol."

package/skills/tagging-and-routing/SKILL.md

@@ -0,0 +1,54 @@
+---
+name: tagging-and-routing
+description: Use when generating tags and a category for a saved nod link. Keep taxonomy tight and useful for filtering and collection routing.
+---
+
+# Tagging and Routing
+
+Goal: produce a small, useful set of tags and one category.
+
+## Tag rules
+
+- Return 3 to 5 tags.
+- Tags must be lowercase.
+- Prefer specific nouns over broad abstractions.
+- Use short hyphenated phrases only when a single word loses meaning.
+- Do not use duplicate or near-duplicate tags.
+- Do not use empty tags like "tech", "news", "innovation", "business" unless the link is truly generic.
+
+## Category rules
+
+Pick exactly one category from this list when possible:
+- ai
+- agents
+- devtools
+- design
+- growth
+- marketing
+- startups
+- media
+- social
+- product
+- engineering
+- research
+- security
+- finance
+- crypto
+- policy
+
+If nothing fits, use: uncategorized
+
+## Mapping hints
+
+- MCP, A2A, agent specs, agent discovery, agent infra -> agents
+- Claude Code, IDE tools, SDKs, APIs, GitHub repos for developers -> devtools
+- prompt injection, auth flaws, exploits, abuse -> security
+- ad strategy, distribution, SEO, GEO, AEO, funnels -> marketing
+- social apps, creator products, messaging, feeds, community products -> social
+- funding, pricing, SaaS economics, revenue, markets -> startups or finance depending on focus
+
+## Output quality
+
+The tags should help a real person filter saved links later.
+Bad: ["technology", "future", "innovation"]
+Good: ["mcp", "prompt-injection", "tool-use", "security"]

package/src/index.ts

@@ -0,0 +1,32 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { registerLinkTools } from "./tools/links.js";
+import { registerCollectionTools } from "./tools/collections.js";
+import { registerSocialTools } from "./tools/social.js";
+import { registerSettingsTools } from "./tools/settings.js";
+import { registerPostTools } from "./tools/posts.js";
+// agent curate tool is registered inside registerLinkTools
+
+const server = new McpServer({
+  name: "nod-shout",
+  version: "0.1.0",
+});
+
+// register all tools
+registerLinkTools(server);
+registerCollectionTools(server);
+registerSocialTools(server);
+registerSettingsTools(server);
+registerPostTools(server);
+
+// start the server on stdio transport
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error("nod-shout mcp server running on stdio");
+}
+
+main().catch((err) => {
+  console.error("fatal error:", err);
+  process.exit(1);
+});

package/src/lib/ai.ts

@@ -0,0 +1,166 @@
+import type { AISummaryResult } from "../types.js";
+import { loadSkills } from "./skills.js";
+
+const OPENAI_API_KEY = process.env.OPENAI_API_KEY;
+const SKILL_CONTEXT = loadSkills(["link-summary", "tagging-and-routing", "collection-routing"]);
+const ALLOWED_CATEGORIES = new Set([
+  "ai",
+  "agents",
+  "devtools",
+  "design",
+  "growth",
+  "marketing",
+  "startups",
+  "media",
+  "social",
+  "product",
+  "engineering",
+  "research",
+  "security",
+  "finance",
+  "crypto",
+  "policy",
+  "uncategorized",
+]);
+
+/**
+ * generate a summary, tags, and category for a link using gpt-4.1-mini.
+ * falls back to basic extraction if no api key or on error.
+ */
+export async function generateSummary(params: {
+  url: string;
+  title: string | null;
+  description: string | null;
+  bodyText: string | null;
+  userContext: string | null;
+}): Promise<AISummaryResult> {
+  const { url, title, description, bodyText, userContext } = params;
+
+  // try ai summarization if key is available
+  if (OPENAI_API_KEY) {
+    try {
+      return await aiSummarize(url, title, description, bodyText, userContext);
+    } catch (err) {
+      console.error("ai summary failed, falling back to basic extraction:", err);
+    }
+  }
+
+  // fallback: basic extraction
+  return basicExtract(title, description);
+}
+
+async function aiSummarize(
+  url: string,
+  title: string | null,
+  description: string | null,
+  bodyText: string | null,
+  userContext: string | null
+): Promise<AISummaryResult> {
+  const prompt = `You are generating data for a nod shout card.${SKILL_CONTEXT}
+
+Follow the skills above. Output one short summary, 3-5 tags, and one category.
+
+Hard rules:
+- summary should help someone decide whether to click
+- 2 short sentences max
+- sentence 1: what the thing is or what happened
+- sentence 2: a reason to click or a key detail
+- include concrete specifics when available
+- never start with: "this article discusses", "this post is about", "the page explains", "X tweeted that", "post by", "page", "clicking gives", "clicking provides", "clicking reveals"
+- never use: "not just X but Y", "isn't just X"
+- tags must be lowercase
+- category must be one of: ${Array.from(ALLOWED_CATEGORIES).join(", ")}
+- if unsure, use uncategorized
+
+url: ${url}
+title: ${title || "unknown"}
+description: ${description || "none"}
+${bodyText ? `page content: ${bodyText}` : ""}
+${userContext ? `user context: ${userContext}` : ""}
+
+respond in json only, no markdown:
+{"summary": "...", "tags": ["...", "..."], "category": "..."}`;
+
+  const response = await fetch("https://api.openai.com/v1/chat/completions", {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${OPENAI_API_KEY}`,
+    },
+    body: JSON.stringify({
+      model: "gpt-4.1-mini",
+      messages: [{ role: "user", content: prompt }],
+      temperature: 0.7,
+      max_tokens: 200,
+      response_format: { type: "json_object" },
+    }),
+    signal: AbortSignal.timeout(15000),
+  });
+
+  if (!response.ok) {
+    throw new Error(`openai api error: ${response.status}`);
+  }
+
+  const data = await response.json();
+  const content = data.choices?.[0]?.message?.content;
+  if (!content) throw new Error("no content in openai response");
+
+  const parsed = JSON.parse(content);
+  return normalizeResult({
+    summary: parsed.summary || description || "no summary available",
+    tags: Array.isArray(parsed.tags) ? parsed.tags.slice(0, 5) : [],
+    category: parsed.category || "uncategorized",
+  });
+}
+
+function normalizeResult(result: AISummaryResult): AISummaryResult {
+  const summary = String(result.summary || "no summary available")
+    .replace(/\s+/g, " ")
+    .trim()
+    .slice(0, 280);
+
+  const tags = Array.from(
+    new Set(
+      (result.tags || [])
+        .map((tag) => String(tag).toLowerCase().trim())
+        .map((tag) => tag.replace(/[^a-z0-9\s-]/g, ""))
+        .map((tag) => tag.replace(/\s+/g, "-"))
+        .filter((tag) => tag.length >= 2 && tag.length <= 32)
+        .filter((tag) => !["technology", "tech", "news", "innovation", "business"].includes(tag))
+    )
+  ).slice(0, 5);
+
+  const category = ALLOWED_CATEGORIES.has(String(result.category || "").toLowerCase().trim())
+    ? String(result.category).toLowerCase().trim()
+    : "uncategorized";
+
+  return { summary, tags, category };
+}
+
+function basicExtract(
+  title: string | null,
+  description: string | null
+): AISummaryResult {
+  const summary = description || title || "no summary available";
+  const text = `${title || ""} ${description || ""}`.toLowerCase();
+  const stopWords = new Set([
+    "the", "a", "an", "is", "are", "was", "were", "be", "been",
+    "being", "have", "has", "had", "do", "does", "did", "will",
+    "would", "could", "should", "may", "might", "can", "shall",
+    "to", "of", "in", "for", "on", "with", "at", "by", "from",
+    "as", "into", "through", "during", "before", "after", "and",
+    "but", "or", "nor", "not", "so", "yet", "both", "either",
+    "neither", "each", "every", "all", "any", "few", "more",
+    "most", "other", "some", "such", "no", "only", "own", "same",
+    "than", "too", "very", "just", "that", "this", "it", "its",
+    "how", "what", "which", "who", "whom", "where", "when", "why",
+    "about", "up", "out", "if", "then", "also", "new", "one",
+  ]);
+  const tags = text
+    .replace(/[^a-z0-9\s-]/g, "")
+    .split(/\s+/)
+    .filter((w) => w.length > 2 && !stopWords.has(w))
+    .slice(0, 5);
+  const category = "uncategorized";
+  return normalizeResult({ summary, tags, category });
+}