حوّل سؤال سوق إلى موجز go-to-market

const BASE = "https://openapi.felo.ai";
const headers = {
  Authorization: `Bearer ${process.env.FELO_API_KEY}`,
  "Content-Type": "application/json",
};

async function felo<T>(path: string, body?: unknown): Promise<T> {
  const res = await fetch(`${BASE}${path}`, {
    method: body ? "POST" : "GET",
    headers,
    body: body ? JSON.stringify(body) : undefined,
  });
  if (!res.ok) throw new Error(`${res.status}: ${await res.text()}`);
  return res.json() as Promise<T>;
}

type ChatData = {
  data: {
    answer: string;
    resources: { link: string; title: string; snippet: string }[];
  };
};

const product = "scheduling tool"; // replace with your product
const segment = "operations teams at 50-200 person companies";
const region = "DACH";

const market = await felo<ChatData>("/v2/chat", {
  query: `Who buys ${product} for ${segment} in ${region}, what do they use today, and what objections come up?`,
});

const seedSources = market.data.resources.slice(0, 5);

type ExtractData = { data: { content: string } };

const marketPages = [
  { url: "https://example.com/category", title: "Category overview" },
  { url: "https://example.com/comparison", title: "Comparison page" },
  { url: "https://example.com/pricing", title: "Pricing page" },
];

const pages = await Promise.all(
  marketPages.map(async (page) => {
    const res = await felo<ExtractData>("/v2/web/extract", {
      url: page.url,
      output_format: "markdown",
      with_readability: true,
      with_cache: true,
    });
    const checkedAt = new Date().toISOString().slice(0, 10);
    return { ...page, checkedAt, content: res.data.content };
  }),
);

type XData = {
  data: {
    tweets: {
      content: string;
      author: { username: string };
      created_at: string;
      metrics: { retweet_count: number; favorite_count: number };
    }[];
  };
};

const since = Math.floor((Date.now() - 90 * 24 * 60 * 60 * 1000) / 1000);

const language = await felo<XData>("/v2/x/tweet/search", {
  query: `(spreadsheet OR "scheduling tool") (alternative OR "looking for")`,
  limit: 25,
  since_time: since,
});

const quotes = language.data.tweets.slice(0, 5);

const today = new Date().toISOString().slice(0, 10);

const sourceLine = (title: string, url: string, date: string) =>
  `- ${title}: ${url} (checked ${date})`;

const brief = [
  `# GTM brief — ${segment} in ${region}`,
  "",
  "## Segment definition",
  "See the category page for how the segment is described. Market size: Not available from public sources reviewed.",
  "",
  "## Buyer language",
  ...quotes.map((post) => `- @${post.author.username}, ${post.created_at.slice(0, 10)}: ${post.content}`),
  "",
  "## Alternatives buyers mention",
  "Spreadsheets, an incumbent suite, and doing nothing. Treated as language until a source ranks them.",
  "",
  "## Objections and proof required",
  "Migration path and a named reference. Marked open: whether the objection changes by company size.",
  "",
  "## Open questions",
  "- How much of the segment already has a dedicated budget line?",
  "- Which objection blocks a pilot most often?",
  "",
  "## Sources",
  ...pages.map((page) => sourceLine(page.title, page.url, page.checkedAt)),
  ...seedSources.map((source) => `- ${source.title}: ${source.link}`),
].join("\n");

console.log(brief);

type LiveDocData = { data: { short_id: string } };

const briefDoc = await felo<LiveDocData>("/v2/livedocs", {
  name: `GTM: ${segment} — ${region}`,
  description: `Market evidence checked ${today}`,
});

await felo(`/v2/livedocs/${briefDoc.data.short_id}/resources/urls`, {
  urls: pages.map((page) => ({ url: page.url, title: page.title })),
});

await felo(`/v2/livedocs/${briefDoc.data.short_id}/resources/doc`, {
  title: `GTM brief ${today}`,
  content: brief,
});

console.log(briefDoc.data.short_id); // reuse for the next region