Skip to content
SlashClone
DiscoverUse in ClaudeSubmit a link
Sign in
Made by@slashclone

Get found in search and see where sign-ups come from

@slashclone/website-traffic

Get your web app found in Google and AI search, and see which channels bring sign-ups. Sets up sitemap, robots, canonical URLs, share images, and structured data with a page checker, then consent-aware first-touch tracking from UTM tags and referral links, saved at sign-up. Includes a launch channel checklist. Engineering guidance, not legal advice.

SkillContentv0.1.0Tested
Use in Claude Save Like Clone Comment
Activity
New: be the first to try it
  1. 1#!/usr/bin/env node
  2. 2// Checks saved HTML pages (and an optional sitemap.xml and robots.txt next to them)
  3. 3// for the discoverability basics: titles, canonical URLs, noindex, share images,
  4. 4// and JSON-LD structured data. Node standard library only. No network.
  5. 5//
  6. 6// Usage:
  7. 7// node scripts/page-check.mjs --pages examples/site --out out/page-check.json [--report-only]
  8. 8//
  9. 9// Exit code: 0 when there are no problems (or with --report-only), 1 otherwise.
  10. 10
  11. 11import { readFileSync, readdirSync, statSync, writeFileSync, mkdirSync, existsSync } from "node:fs";
  12. 12import { join, relative, dirname } from "node:path";
  13. 13
  14. 14function args(argv) {
  15. 15 const out = { pages: "", out: "out/page-check.json", reportOnly: false };
  16. 16 for (let i = 0; i < argv.length; i++) {
  17. 17 const a = argv[i];
  18. 18 if (a === "--pages") out.pages = argv[++i] ?? "";
  19. 19 else if (a === "--out") out.out = argv[++i] ?? out.out;
  20. 20 else if (a === "--report-only") out.reportOnly = true;
  21. 21 else throw new Error(`Unknown argument: ${a}`);
  22. 22 }
  23. 23 if (!out.pages) throw new Error("Pass --pages <folder of saved .html files>");
  24. 24 return out;
  25. 25}
  26. 26
  27. 27function htmlFiles(dir) {
  28. 28 const found = [];
  29. 29 for (const name of readdirSync(dir)) {
  30. 30 const full = join(dir, name);
  31. 31 if (statSync(full).isDirectory()) found.push(...htmlFiles(full));
  32. 32 else if (name.endsWith(".html")) found.push(full);
  33. 33 }
  34. 34 return found.sort();
  35. 35}
  36. 36
  37. 37const decode = (s) =>
  38. 38 s
  39. 39 .replace(/&lt;/g, "<")
  40. 40 .replace(/&gt;/g, ">")
  41. 41 .replace(/&quot;/g, '"')
  42. 42 .replace(/&#39;/g, "'")
  43. 43 .replace(/&amp;/g, "&");
  44. 44
  45. 45function attr(tag, name) {
  46. 46 const m = tag.match(new RegExp(`\\b${name}\\s*=\\s*("([^"]*)"|'([^']*)')`, "i"));
  47. 47 return m ? decode(m[2] ?? m[3] ?? "") : undefined;
  48. 48}
  49. 49
  50. 50function tags(html, tagName) {
  51. 51 return html.match(new RegExp(`<${tagName}\\b[^>]*>`, "gi")) ?? [];
  52. 52}
  53. 53
  54. 54function readPage(html) {
  55. 55 const titleMatch = html.match(/<title[^>]*>([\s\S]*?)<\/title>/i);
  56. 56 const title = titleMatch ? decode(titleMatch[1]).trim() : "";
  57. 57 const canonical = tags(html, "link")
  58. 58 .filter((t) => (attr(t, "rel") ?? "").toLowerCase().split(/\s+/).includes("canonical"))
  59. 59 .map((t) => attr(t, "href"))[0];
  60. 60 const robots = tags(html, "meta")
  61. 61 .filter((t) => (attr(t, "name") ?? "").toLowerCase() === "robots")
  62. 62 .map((t) => (attr(t, "content") ?? "").toLowerCase())
  63. 63 .join(",");
  64. 64 const ogImage = tags(html, "meta")
  65. 65 .filter((t) => (attr(t, "property") ?? "").toLowerCase() === "og:image")
  66. 66 .map((t) => attr(t, "content"))[0];
  67. 67 const ldBlocks = [
  68. 68 ...html.matchAll(
  69. 69 /<script\b[^>]*type\s*=\s*["']application\/ld\+json["'][^>]*>([\s\S]*?)<\/script>/gi,
  70. 70 ),
  71. 71 ].map((m) => m[1]);
  72. 72 return { title, canonical, noindex: /\bnoindex\b/.test(robots), ogImage, ldBlocks };
  73. 73}
  74. 74
  75. 75// Flatten JSON-LD: arrays, @graph, and nested objects that carry an @type.
  76. 76function nodes(value, acc = []) {
  77. 77 if (Array.isArray(value)) value.forEach((v) => nodes(v, acc));
  78. 78 else if (value && typeof value === "object") {
  79. 79 if (value["@type"]) acc.push(value);
  80. 80 for (const [k, v] of Object.entries(value)) if (k !== "@context") nodes(v, acc);
  81. 81 }
  82. 82 return acc;
  83. 83}
  84. 84
  85. 85const typesOf = (node) => [].concat(node["@type"]).map(String);
  86. 86const hasMarkup = (s) => /<[a-z!/][^>]*>/i.test(s);
  87. 87const isAbsoluteHttps = (u) => {
  88. 88 try {
  89. 89 return new URL(u).protocol === "https:";
  90. 90 } catch {
  91. 91 return false;
  92. 92 }
  93. 93};
  94. 94
  95. 95function checkLd(node, problem) {
  96. 96 const types = typesOf(node);
  97. 97 if (types.includes("FAQPage")) {
  98. 98 const qs = [].concat(node.mainEntity ?? []);
  99. 99 if (qs.length === 0) problem("FAQPage has no questions");
  100. 100 qs.forEach((q, i) => {
  101. 101 const text = q?.acceptedAnswer?.text;
  102. 102 if (!q?.name) problem(`FAQPage question ${i + 1} has no name`);
  103. 103 if (typeof text !== "string" || !text.trim())
  104. 104 problem(`FAQPage question ${i + 1} has no answer text`);
  105. 105 else if (hasMarkup(text)) problem(`FAQPage answer ${i + 1} contains markup; use plain text`);
  106. 106 });
  107. 107 }
  108. 108 if (types.some((t) => t === "Product" || t === "SoftwareApplication")) {
  109. 109 const offers = [].concat(node.offers ?? []);
  110. 110 if (offers.length === 0)
  111. 111 problem(`${types.join("/")} has no offers; state the real price (0 for free)`);
  112. 112 offers.forEach((o, i) => {
  113. 113 if (o?.price === undefined || o?.price === "" || Number.isNaN(Number(o.price)))
  114. 114 problem(`${types.join("/")} offer ${i + 1} has no numeric price`);
  115. 115 if (!o?.priceCurrency) problem(`${types.join("/")} offer ${i + 1} has no priceCurrency`);
  116. 116 });
  117. 117 }
  118. 118 if (types.includes("ItemList")) {
  119. 119 const items = [].concat(node.itemListElement ?? []);
  120. 120 if (items.length === 0) problem("ItemList is empty");
  121. 121 items.forEach((it, i) => {
  122. 122 if (typeof it?.position !== "number")
  123. 123 problem(`ItemList item ${i + 1} has no numeric position`);
  124. 124 if (!it?.url && !it?.item) problem(`ItemList item ${i + 1} has no url or item`);
  125. 125 });
  126. 126 }
  127. 127}
  128. 128
  129. 129function sitemapUrls(dir) {
  130. 130 const file = join(dir, "sitemap.xml");
  131. 131 if (!existsSync(file)) return null;
  132. 132 const xml = readFileSync(file, "utf8");
  133. 133 return [...xml.matchAll(/<loc>\s*([^<\s]+)\s*<\/loc>/gi)].map((m) => decode(m[1]));
  134. 134}
  135. 135
  136. 136function main() {
  137. 137 const opts = args(process.argv.slice(2));
  138. 138 const problems = [];
  139. 139 const pages = [];
  140. 140 const sitemap = sitemapUrls(opts.pages);
  141. 141 const robotsFile = join(opts.pages, "robots.txt");
  142. 142 const robots = existsSync(robotsFile) ? readFileSync(robotsFile, "utf8") : null;
  143. 143
  144. 144 if (robots !== null && !/^\s*sitemap:\s*https:\/\//im.test(robots))
  145. 145 problems.push({ file: "robots.txt", problem: "robots.txt has no absolute https Sitemap line" });
  146. 146 if (sitemap) {
  147. 147 for (const u of sitemap)
  148. 148 if (!isAbsoluteHttps(u))
  149. 149 problems.push({ file: "sitemap.xml", problem: `not an absolute https URL: ${u}` });
  150. 150 }
  151. 151
  152. 152 const titles = new Map();
  153. 153 for (const file of htmlFiles(opts.pages)) {
  154. 154 const rel = relative(opts.pages, file);
  155. 155 const page = readPage(readFileSync(file, "utf8"));
  156. 156 const problem = (p) => problems.push({ file: rel, problem: p });
  157. 157 const ldTypes = [];
  158. 158
  159. 159 if (!page.title) problem("no <title>");
  160. 160 if (!page.noindex) {
  161. 161 if (page.title) titles.set(page.title, [...(titles.get(page.title) ?? []), rel]);
  162. 162 if (!page.canonical) problem("indexable page has no canonical link");
  163. 163 else if (!isAbsoluteHttps(page.canonical)) problem("canonical is not an absolute https URL");
  164. 164 if (!page.ogImage) problem("indexable page has no og:image share image");
  165. 165 if (sitemap && page.canonical && !sitemap.includes(page.canonical))
  166. 166 problem("indexable page is missing from sitemap.xml");
  167. 167 } else if (sitemap && page.canonical && sitemap.includes(page.canonical)) {
  168. 168 problem("noindex page is listed in sitemap.xml");
  169. 169 }
  170. 170
  171. 171 for (const block of page.ldBlocks) {
  172. 172 let data;
  173. 173 try {
  174. 174 data = JSON.parse(block);
  175. 175 } catch {
  176. 176 problem("JSON-LD block is not valid JSON");
  177. 177 continue;
  178. 178 }
  179. 179 for (const node of nodes(data)) {
  180. 180 ldTypes.push(...typesOf(node));
  181. 181 checkLd(node, problem);
  182. 182 }
  183. 183 }
  184. 184 pages.push({
  185. 185 file: rel,
  186. 186 title: page.title,
  187. 187 indexable: !page.noindex,
  188. 188 canonical: page.canonical ?? null,
  189. 189 jsonLd: ldTypes,
  190. 190 });
  191. 191 }
  192. 192
  193. 193 for (const [title, files] of titles)
  194. 194 if (files.length > 1)
  195. 195 problems.push({ file: files.join(", "), problem: `duplicate title: ${title}` });
  196. 196
  197. 197 const report = {
  198. 198 problems,
  199. 199 pages,
  200. 200 sitemap: sitemap ? { urls: sitemap.length } : null,
  201. 201 robots: robots !== null,
  202. 202 };
  203. 203 mkdirSync(dirname(opts.out), { recursive: true });
  204. 204 writeFileSync(opts.out, JSON.stringify(report, null, 2) + "\n");
  205. 205 for (const p of problems) console.log(`problem: ${p.file}: ${p.problem}`);
  206. 206 console.log(`${pages.length} pages checked, ${problems.length} problems. Report: ${opts.out}`);
  207. 207 if (problems.length && !opts.reportOnly) process.exit(1);
  208. 208}
  209. 209
  210. 210try {
  211. 211 main();
  212. 212} catch (err) {
  213. 213 console.error(err instanceof Error ? err.message : String(err));
  214. 214 process.exit(2);
  215. 215}
Sign in to comment on a line

Cookie settings

Cookies that keep you signed in and remember these choices are always on. Everything else is off until you turn it on.