韩国文化遗产AI工具

Installation

npm install @heripo/research-radar @llm-newsletter-kit/core

Requirements: Node.js >= 24, OpenAI API key, content generation API key (OpenAI / Anthropic / Google)

Note: @llm-newsletter-kit/core is a peer dependency and must be installed separately.

build

npm run build # clean dist/ and build with Rollup (CJS + ESM + types)

Quick Start

import { generateNewsletter } from '@heripo/research-radar';

const newsletterId = await generateNewsletter({
  openAIApiKey: process.env.OPENAI_API_KEY,
  contentGeneration: {
    provider: 'anthropic',           // 'openai' | 'anthropic' | 'google'
    apiKey: process.env.ANTHROPIC_API_KEY,
    // model: 'claude-sonnet-4-6',   // optional, uses sensible default
  },

  // Implement these repository interfaces (see src/types/dependencies.ts)
  taskRepository: {
    createTask: async () => db.tasks.create({ status: 'running' }),
    completeTask: async (id) => db.tasks.update(id, { status: 'completed' }),
  },

  articleRepository: {
    findByUrls: async (urls) => db.articles.findByUrls(urls),
    saveCrawledArticles: async (articles, ctx) => db.articles.save(articles, ctx),
    findUnscoredArticles: async () => db.articles.findUnscored(),
    updateAnalysis: async (article) => db.articles.updateAnalysis(article),
    findCandidatesForNewsletter: async () => db.articles.findCandidates(),
  },

  tagRepository: {
    findAllTags: async () => db.tags.findAll(),
  },

  newsletterRepository: {
    getNextIssueOrder: async () => db.newsletters.getNextOrder(),
    saveNewsletter: async (data) => db.newsletters.save(data),
  },

  // Optional parameters:
  logger: console,
  publishDate: '2026-02-20',        // Override publication date (ISO format)
  templateOptions: { /* ... */ },    // Newsletter template customization
  customFetch: proxyFetch,           // Custom fetch for proxy-based crawling
  previewNewsletter: {
    fetchNewsletterForPreview: async () => db.newsletters.latest(),
    emailService: resendEmailService,
    emailMessage: { from: 'news@example.com', to: 'preview@example.com' },
  },
});

Repository interfaces are defined in src/types/dependencies.ts. Each method signature includes JSDoc with expected input/output types.

Components

Config (src/config/): Brand, language, LLM settings

Targets (src/config/crawling-targets.ts): 66 sources (News 52, Business 4, Employment 10)

Parsers (src/parsers/): Custom extractors per organization

Templates (src/templates/): newsletter-html.ts (responsive email with light/dark mode), welcome-html.ts (generateWelcomeHTML()), shared.ts (shared HTML components)