index-now
Val Town is a collaborative website to build and scale JavaScript apps.
Deploy APIs, crons, & store data – all from the browser, and deployed in milliseconds.
Viewing readonly version of main branch: v62View latest version
This val automates IndexNow submission by:
- Crawling sitemap URLs.
- Tracking submission history in project-scoped SQLite.
- Submitting only changed URLs in batches (up to 10,000 URLs per POST).
indexnow.cron.ts: scheduled automation trigger.indexnow.http.ts: manual trigger for dry runs and debugging.indexnow.monitor.http.ts: monitoring endpoint for submission health/history.
The recommended setup is a cron trigger every hour for sitemap polling, plus the HTTP trigger when you want immediate/manual control.
INDEXNOW_ENDPOINT(optional): defaults tohttps://api.indexnow.org/indexnow.INDEXNOW_MAX_URLS_PER_RUN(optional): defaults to5000.
Site configs live in config/sites/*.json with one site per file.
At least one file must exist or the val will throw on startup.
Example: config/sites/hanayou.studio.json
{ "host": "www.hanayou.studio", "sitemapUrl": "https://www.hanayou.studio/sitemap.xml", "keyLocation": "https://www.hanayou.studio/2dc12b205bfe46d19a75077e3991f7ce.txt", "key": "optional-explicit-key", "includePrefixes": ["/journal/", "/guides/"], "excludePrefixes": ["/tag/", "/author/"] }
- Dry run:
?dryRun=1 - Force resubmit currently eligible URLs:
?force=1 - Target a single configured site:
?site=www.hanayou.studio - Response includes stage-specific URL arrays:
siteRuns[].filteredUrlsfor URLs that passed filters.siteRuns[].changedUrlsfor URLs detected as changed.siteRuns[].queuedUrlsfor changed URLs after run-cap limiting.siteRuns[].submittedCountcounts only HTTP200responses.- HTTP
202responses are tracked as pending insiteRuns[].pendingCount.
Example:
https://<your-val>.web.val.run/?dryRun=1&site=www.hanayou.studio
- Path:
indexnow.monitor.http.tsendpoint - Purpose: IndexNow health snapshot from config + SQLite state
- Query params:
site(optional): limit report to one configured host.runs(optional): recent run history per site (default 10, max 50).
Response highlights:
totals.submitted200Urls: URLs with confirmed HTTP200submission state.totals.pending202Urls: URLs last seen with HTTP202(pending).sites[].latestRun: latest run summary per site.sites[].recentRuns: recent run history per site.
SQLite tables:
indexnow_url_state_v1: per-URL state (seen/submitted timestamps, lastmod, status).indexnow_run_log_v1: per-run summaries for observability and debugging.
This val uses https://esm.town/v/std/sqlite/main.ts so data is scoped to this val project.