How to Find Short Descriptions with CLI
Detect pages with short meta descriptions (under 50 characters) using crawler.sh CLI. Find underwritten snippets and improve search visibility.
Short meta descriptions - those under 50 characters - fail to make full use of the snippet space in search results. A description like “Welcome to our site” provides no useful information and gives users no reason to click. Search engines may even ignore overly short descriptions and generate their own.
This guide shows you how to find every page with a short meta description using the crawler.sh CLI.
Step 1: Install crawler.sh CLI
Install the CLI with a single command:
curl -fsSL https://install.crawler.sh | shThis downloads the correct binary for your operating system and architecture, places it in ~/.crawler/bin/, and adds it to your PATH. Restart your terminal or run source ~/.bashrc (or ~/.zshrc) to pick up the new PATH entry.
Verify the installation:
crawler --versionStep 2: Crawl the target website
Run a full crawl of the website you want to audit:
crawler crawl https://example.comThe crawler records each page’s meta description. Results are saved as an NDJSON file (.crawl) in the current directory. For larger sites:
crawler crawl https://example.com --max-pages 5000Step 3: Run SEO audit
Run the SEO analysis on your crawl data:
crawler seo example-com.crawlThe short descriptions check flags any page where the meta description is under 50 characters.
Step 4: Identify short descriptions
Look for the Short Descriptions section in the SEO report. Common examples include:
- Placeholder text left by developers (“Description here”, “TBD”)
- Descriptions that only repeat the page title
- Auto-generated snippets from CMS plugins that truncate too aggressively
- Brand-only descriptions (“Company Name - Official Site”)
Step 5: Fix and re-crawl
Expand each short description to between 50 and 160 characters. A good meta description:
- Summarizes what the user will find on the page
- Includes relevant keywords naturally
- Gives a reason to click (benefit, feature, or call to action)
- Reads as a complete, coherent sentence
After fixing, re-crawl to verify:
crawler crawl https://example.comcrawler seo example-com.crawlWhy short descriptions matter for SEO
Google displays up to about 155 characters of a meta description in search results. Descriptions under 50 characters use less than a third of that space, leaving your listing looking sparse compared to competitors. Longer, well-written descriptions increase click-through rates and help search engines understand your page content better. Expanding short descriptions is a low-effort improvement with measurable impact on organic traffic.