Connect your site
In Lettercamp Cloud, open the site’s Insights page and select Connect Google Search Console. Choose a Google account with access to the property you want to share. It can differ from your Lettercamp account. A paired workspace uses its own site automatically. With a CLI login, the command uses the folder’s deployment site or, in an unbound folder, your only accessible site. If you have several sites, select one explicitly withnpx lettercamp insights --site my-blog.
Choose what to write
Look at the reader’s wording and the reportedlandingPage together. For example, if “how to feed a sourdough starter in winter” leads to your starter care guide, read its feeding instructions. A short section on cold kitchens may answer that question. If Google returns landingPage: null, search your existing posts before starting a new one.
Use a view when you have a specific editorial question:
Read the JSON
A ready report includes the selected Googleproperty, the reporting scope, the last sync time (syncedAt), and date ranges for the latest 28 days and the previous 28 days. Each query includes clicks, impressions, click-through rate as a fraction, and average position. The prior object holds the same metrics for the earlier period. A value of null means Google did not report a comparison row. Google can omit low-volume queries.
Check status before reading queries. For not_connected or setup_required, open insightsUrl and select the named Lettercamp site. For pending, retry shortly. For unavailable, read message. A ready report with an empty queries array means the current selection has no matching rows.
For a larger batch, use --limit (1–100). Pass the returned nextOffset to --offset with the same topic and view to get the next batch. A null nextOffset marks the end.