Flapbase
A workspace that grows with your business — services, products, creative work, development. Any kind of project.
Open source. Use it with your AI agents, from your own code, or in Flapbase Cloud. New tools arrive every week.
日本語
Site check
Check locally how search engines and AI read a site. Pass a public URL, a saved HTML file or a folder; you get what to fix, in order, with the reason. No account or API key. Node.js 22+, no external dependencies.
Problems to fix before publishing: 7
1. The publish folder contains .env (1 page: .env). Fix: Remove .env from the publish folder.
2. An HTTPS page loads an HTTP resource (1 page: index.html). Fix: Use HTTPS for the resource URL.
git clone https://github.com/Flapbase/flapbase.git
cd flapbase
node bin/flap.js check examples/travel-broken
The npm package is @flapbase/cli and the command is flap. Once published to npm:
npx --yes @flapbase/[email protected] check https://flapbase.com
npx --yes @flapbase/[email protected] check ./site --json
What it checks
- The 11 basics: doctype, language, charset, mobile viewport, title, description, canonical URL, main heading, structured data (JSON-LD), content in the initial HTML, noindex.
- How AI reads the site: robots.txt, search, answer and training crawlers, organization structured data, responses per language, sitemap.
- Facts in the initial HTML: price, service area and booking method, from text, headings and JSON-LD. Choose them with
--facts price,area,booking.
- Booking, contact and purchase links and forms, including mobile menus: source, label and final destination. URL checks follow redirects; folder checks resolve local files.
- Prices in yen, opening days, addresses and phone numbers across pages, languages and JSON-LD.
- Publication accidents:
.env, .git, private key files and HTTP resources on HTTPS pages.
- Problems grouped by rule and cause, with affected pages, evidence and where to fix them.
--baseline separates fixed, new and continuing problems.
--json returns the same result as JSON. The text output is built from it.
node bin/flap.js check https://flapbase.com --json
node bin/flap.js check examples/apparel/index.html
node bin/flap.js check examples/travel --base-url https://example.com/travel/
Save a result, make changes and check again:
node bin/flap.js check ./site --json > /tmp/site-before.json
node bin/flap.js check ./site --baseline /tmp/site-before.json
node bin/flap.js check ./site --facts price,booking --json
For a file, robots.txt and the sitemap are read from the same folder; for a folder, from its root. No URL is fetched in that case. Anything that could not be read is reported as "unchecked". The exit code is 0 even when fixes are found, and 1 when the input or a fetch fails.
URL fetching is limited to public HTTPS sites; private networks and local devices are refused. Limits: HTML 1 MiB and 10 s, robots.txt 64 KiB, sitemap 256 KiB, 3 redirects. Folders: up to 100 HTML files, 8 MiB in total, depth 8.
Flapbase
Flapbase is a workspace for growing your business. This repository opens it so anyone can run it locally.
- Developers can use it directly in their own projects.
- AI agents such as Claude Code and Codex (ChatGPT) can use it in a few steps.
- Prefer a visual interface? Use Flapbase Cloud. The results are the same.
Use from AI agents
Install the skills in Claude Code, Codex (ChatGPT) and other agents with one line:
npx skills add Flapbase/flapbase
Skills are grouped by what you are trying to do. Within a group, use them top to bottom.
Understand the business
| Skill | What it does |
|---|
| flapbase-acquisition-check | Lays out ad spend, visits, inquiries, deals and sales, shows where people drop off and what each lead costs |
| flapbase-business-profile-check | Checks the business profile and service list, and rewrites the profile so it earns trust and inquiries |
| flapbase-ai-adoption | Starts using chat AI at work: which tasks to hand off, prompt templates, and what not to put into AI |
| flapbase-business-map | Answers "what should we fix now?" by picking one question and only the analyses it needs, with evidence marked as observed, external, estimated or hypothesis |
| flapbase-measures-inventory | Takes stock of your marketing as audience × action × tool, without forms, and finds what to add, fix, tidy or stop |
Site and AI visibility (in order)
| Skill | What it does |
|---|
| flapbase-site-check | 1. Runs the site check locally and explains the fixes |
| flapbase-site-diagnosis | 2. Checks the content: what an AI needs to recommend the site |
| flapbase-ai-visibility | 3. Checks every week whether AI assistants name the business correctly, and which comparison searches and lists matter |
| flapbase-mail-check | Checks whether email to customers is set up to arrive (SPF, DKIM, DMARC) from public DNS, and gives the values to enter |
| flapbase-site-migrate | Moves an existing site (HTML, React, Astro, WordPress export) into Flap Site |
Publishing
여기까지가 README 앞부분입니다. 나머지는 원문에서 읽을 수 있습니다. README 전문 보기 ↗
