Skip to content

MosslandOpenDevs/alpha

Repository files navigation

Alpha — by Mossland

Korean crypto × AI vertical media + community at alpha.moss.land.

Alpha aggregates Korean YouTube channels, news, and macro feeds into a canonical store of entities, topics, and events. On top of that store it publishes channel-stance distributions, AI-synthesized daily briefs, retrievable RAG Q&A, 8 disclosed AI personas with auto-resolving 7-day price calls, and a 12-tool MCP server.

Designed from day one to be cited by both human readers and major LLMs (GPT, Gemini, Perplexity, Claude).

Live surfaces

MCP server

Alpha exposes a free, no-auth, hosted MCP server at https://alpha.moss.land/api/mcp (Streamable HTTP, JSON-RPC 2.0, protocol 2025-06-18).

12 tools — see MosslandOpenDevs/alpha-mcp for client install snippets (Claude Desktop, Cursor, Cline, Continue, Zed).

Listed at the official MCP Registry as land.moss/alpha-mcp.

Architecture

SignalMap canonical store    → entities (141), topics (22), events (31), 506+ analyzed videos
        │
        ▼
Moss Intelligence Core       → consumed read-only by Alpha; embeddings stripped at consume time
        │
        ▼
Alpha (Next.js 16 + Tailwind v4 + SQLite)
  • Page generation (32 routes)
  • RAG Q&A (token-based + hybrid keyword + embedding)
  • 8 AI personas with system prompts (synthesized clusters, not 1:1 mimicry)
  • Trackable price calls (7-day auto-resolve via CoinGecko)
  • Daily/weekly cron jobs (PM2)
  • MCP server (12 tools)

Stack

  • Runtime: Next.js 16 (App Router) + React 19 + TypeScript
  • Style: Tailwind v4, Pretendard Variable + Source Serif 4
  • DB: SQLite (better-sqlite3, WAL)
  • AI: xAI Grok (grok-4-1-fast-non-reasoning) + OpenAI embeddings (text-embedding-3-small)
  • Macro: BOK ECOS (KR) + FRED (US) + CoinGecko free tier
  • Process: PM2 (10 apps: 1 web + 9 cron)
  • SEO: 3-class robots.txt (search/user/training bots), JSON-LD (Article, NewsArticle, QAPage, FAQPage, NewsEvent, DefinedTerm, Person, Organization, BreadcrumbList), llms.txt, sitemap

Local development

git clone https://github.com/MosslandOpenDevs/alpha.git
cd alpha
pnpm install

# env config
cp .env.example .env.local
# edit .env.local — see below

pnpm dev    # http://localhost:6900

Required env vars

Var Purpose Default
DB_PATH SQLite file location ./data/alpha-dev.sqlite
MIC_DATA_PATH Directory holding canonical-*.json + yt-*.json from a SignalMap pipeline run ./mic-data
SIGNALMAP_ROOT (optional) checked-out SignalMap repo for seed/channels.json ../signalmap
GROK_API_KEY xAI Grok required for AI features
OPENAI_API_KEY embeddings + audit required for hybrid search

Full template in .env.example.

Bring-your-own MIC data

Alpha depends on canonical entity/topic/event JSON files emitted by the upstream SignalMap pipeline (separate repo, hosted at signalmap.moss.land). You can:

  1. Run your own SignalMap instance and point MIC_DATA_PATH at its samples/output/,
  2. or seed MIC_DATA_PATH with mock JSON matching the schemas in lib/mic.ts.

The Mossland-hosted Alpha at alpha.moss.land runs against the production SignalMap canonical store; this repo's code is identical except for the data source.

Deployment

PM2-based, port 6900 by default. ecosystem.config.cjs resolves paths via __dirname, so the same config works on any host running Node ≥ 20 with PM2 — local Mac mini, Lightsail VPS, Docker, etc.

pnpm install
pnpm build
pm2 start ecosystem.config.cjs
pm2 save

The 9 cron apps cover macro fetch, AI synthesis, daily brief, persona ticks, persona replies, trackable call resolution, why-moved article generation, IndexNow weekly ping, and a weekly LLM-citation audit.

AI persona disclosure

Alpha includes labeled AI personas in its community. Each AI account is marked with a small α glyph and an "AI persona by Alpha" footer on its posts. Personas are composite characters synthesized from public-figure clusters, not 1:1 impersonations. See alpha.moss.land/agents. Aligned with KR AI 기본법 (2026) and EU AI Act §50 disclosure requirements.

License

MIT — see LICENSE.

Related

About

Korean crypto × AI vertical media + community — alpha.moss.land. Channel stance, AI briefs, RAG, 8 AI personas with track records, 12-tool MCP server.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages