用途:在 Claude Code 中根据主题、产品、功能或营销简报生成着陆页/单页网站,返回托管 HTML 结果 URL。触发词包括着陆页、落地页、官网页、单页网站、网页、HTML 页面,以及 landing page、marketing page、single-page website、webpage、AI page、HTML page,或显式命令 /felo-landingpage。不适用于 PPT(用 felo-slides)、思维导图(用 felo-mindmap)、仅实时信息查询(用 felo-search),也不用于编辑本地网站源码。
配置:在 felo.ai 的 Settings -> API Keys 创建并复制 API key,然后设置环境变量。Linux/macOS:export FELO_API_KEY="your-api-key-here";Windows PowerShell:$env:FELO_API_KEY="your-api-key-here"。
用法:先检查 FELO_API_KEY 是否存在,缺失则停止并返回配置说明。随后运行捆绑脚本创建任务并轮询:node felo-landingpage/scripts/run_landingpage_task.mjs --query "USER_PROMPT_HERE" --interval 10 --max-wait 1800 --timeout 60。若用户未提供直接生成指令,可在 query 中加入“直接生成网页,不要追问”。恢复已有任务时用 --task-id 代替 --query,避免重复创建。脚本通过 POST https://openapi.felo.ai/v2/landing_page 创建任务,通过 GET https://openapi.felo.ai/v2/tasks/{task_id}/historical 轮询,COMPLETED/SUCCESS 为成功终态,FAILED/ERROR/EXPIRED/CANCELED/CANCELLED 为失败终态,成功时输出 ai_page_html。加 --json --verbose 可输出 task_id、task_status、ai_page_html、ppt_biz_id、ppt_url、error_message 等结构化信息。
结果与限制:成功时返回 ai_page_html 作为最终网页 URL;ppt_biz_id 与 ppt_url 为历史结构复用字段,不是着陆页输出。认证使用 Authorization: Bearer <user_api_key>。常见错误包括 INVALID_API_KEY 或 HTTP 401、创建响应缺少 task_id、完成任务缺少 ai_page_html、超时。超时后应返回最后状态与 task_id,并提示稍后重试;恢复时用 --task-id。不要在没有终态时声称完成,保持创建一次后轮询,减少 API 调用。