← 返回
未分类 Key 中文

sitemd

Build and manage websites from Markdown. Create pages, generate content, configure settings, and deploy — all through MCP tools.
使用 Markdown 构建和管理网站。创建页面、生成内容、配置设置、部署——全程通过 MCP 工具完成。
tyler-berggren tyler-berggren 来源
未分类 clawhub v0.1.3 1 版本 100000 Key: 需要
★ 0
Stars
📥 373
下载
💾 0
安装
1
版本
#deploy#latest#markdown#mcp#static-site#website

概述

sitemd

Build websites from Markdown with MCP tools. Works as an OpenClaw skill or plugin — your agent can create, manage, and deploy websites through conversation.

First Steps

  1. If no binary (sitemd/sitemd does not exist) — run ./sitemd/install to download it
  2. Call sitemd_status to understand the project state
  3. If fresh project — read files in pages/, then create pages with sitemd_pages_create
  4. Call sitemd_site_context with a content type to get site identity, conventions, and existing pages
  5. Validate with sitemd_content_validate
  6. Deploy with sitemd_deploy

Authentication

sitemd uses email magic links. When your owner needs to log in:

  1. Call sitemd_auth_login — returns a browser URL
  2. Send the URL to your owner as a message (WhatsApp, Telegram, Discord, etc.)
  3. They tap the link and complete login in their browser
  4. Call sitemd_auth_poll every few seconds until it returns approved

For automated deploys, use sitemd_auth_api_key to create a long-lived key, then set SITEMD_TOKEN in your environment.

Project Structure

  • sitemd — Compiled binary (run ./sitemd/sitemd launch)
  • install — Bootstrap script (run ./sitemd/install to download binary)
  • pages/ — Markdown content files with YAML frontmatter
  • settings/ — Site configuration (YAML frontmatter in .md files)
  • theme/ — CSS and HTML templates
  • media/ — Images and assets
  • site/ — Built output

MCP Tools

ToolPurpose
------
sitemd_statusProject state overview
sitemd_pages_createCreate new pages (writes file + nav + groups)
sitemd_pages_create_batchCreate multiple pages in one call
sitemd_pages_deleteDelete a page (cleans up nav + groups)
sitemd_groups_add_pagesAdd pages to group sidebar
sitemd_site_contextSite identity, pages, conventions
sitemd_content_validateValidate content quality
sitemd_seo_auditSEO health check with scored report
sitemd_initInitialize project from template
sitemd_buildBuild without deploying
sitemd_deployBuild and deploy site
sitemd_activateActivate site (permanent)
sitemd_cloneClone an existing website
sitemd_config_setSet backend config (routes secrets vs non-secrets)
sitemd_auth_loginStart login flow
sitemd_auth_pollPoll for login completion
sitemd_auth_statusCheck auth state and license info
sitemd_auth_api_keyCreate API key for automation
sitemd_auth_setupEnable user authentication
sitemd_update_checkCheck for updates
sitemd_update_applyApply updates

Read pages, settings, and groups files directly — no MCP tool needed for reads.

Settings Files

All configuration is in settings/*.md frontmatter:

FileControls
------
meta.mdSite title, brand name, description, URL
header.mdNavigation items, brand display, search
footer.mdFooter links, copyright, social
groups.mdPage groups for sidebars and dropdowns
theme.mdColors, fonts, layout, light/dark/paper modes
build.mdDev server port, output directory
deploy.mdDomain, deploy target
seo.mdOG images, sitemaps, structured data

Content Types

sitemd supports structured content generation. Call sitemd_site_context with a type to get conventions and existing pages. The syntax reference is below.

  • page — General pages. Second person, present tense, lead with reader value.
  • docs — Documentation. Imperative mood, show what to type, code blocks, tables.
  • blog — Blog posts. Opinionated, date line, 400-1200 words.
  • changelog — Release notes. Terse, Added/Changed/Fixed/Removed sections.
  • roadmap — Product roadmap. Shipped/In Progress/Planned sections.

Markdown Extensions

Beyond standard markdown, sitemd supports rich components. The syntax reference is below.

  • button: Label: /slug — styled buttons. Modifiers: +outline, +big, +newtab, +color:red
  • card: Title / card-text: / card-image: / card-link: — responsive card grids
  • embed: URL — auto-detects YouTube, Vimeo, Spotify, X, CodePen, etc.
  • gallery: with indented !alt — image grid with lightbox
  • image-row: with indented !alt — equal-height image row
  • !alt — image modifiers
  • [text]{tooltip content} — inline tooltips
  • modal: id with indented content, trigger via link — modal dialogs
  • {#custom-id} — inline anchors
  • text — link modifiers
  • form: with indented YAML — forms
  • gated: type1, type2 ... /gated — gated sections
  • data: source / data-display: cards|list|table — dynamic data

版本历史

共 1 个版本

  • v0.1.3 当前
    2026-05-03 08:35 安全 安全

安全检测

腾讯云安全 (Keen)

安全,无风险
查看报告

腾讯云安全 (Sanbu)

安全,无风险
查看报告

🔗 相关推荐

dev-programming

Mcporter

steipete
使用 mcporter CLI 直接列出、配置、认证及调用 MCP 服务器/工具(支持 HTTP 或 stdio),涵盖临时服务器、配置编辑及 CLI/类型生成功能。
★ 196 📥 67,936
ai-agent

sitemd plugin

tyler-berggren
使用 Markdown 构建和管理网站。创建页面、生成内容、配置设置、部署——全程通过 MCP 工具完成。
★ 0 📥 441
dev-programming

CodeConductor.ai

larsonreever
AI驱动平台,提供快速全栈开发、智能体、工作流自动化及低代码AI集成的可扩展产品创建。
★ 75 📥 182,402