{"id":15011131,"url":"https://github.com/torus-tools/seo_audit","last_synced_at":"2026-01-19T21:33:14.305Z","repository":{"id":42833422,"uuid":"263802688","full_name":"torus-tools/seo_audit","owner":"torus-tools","description":"Audit your site's performance with Lighthouse 6 and save the results locally. ","archived":false,"fork":false,"pushed_at":"2022-12-12T21:41:33.000Z","size":16665,"stargazers_count":1,"open_issues_count":24,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-10-19T09:50:59.994Z","etag":null,"topics":["audit","css","html","javascript","nodejs","site"],"latest_commit_sha":null,"homepage":"https://arjan.tools/audit.html","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/torus-tools.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-05-14T03:12:37.000Z","updated_at":"2020-09-19T12:17:54.000Z","dependencies_parsed_at":"2023-01-28T01:31:15.970Z","dependency_job_id":null,"html_url":"https://github.com/torus-tools/seo_audit","commit_stats":null,"previous_names":["arjan-tools/audit"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/torus-tools/seo_audit","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/torus-tools%2Fseo_audit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/torus-tools%2Fseo_audit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/torus-tools%2Fseo_audit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/torus-tools%2Fseo_audit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/torus-tools","download_url":"https://codeload.github.com/torus-tools/seo_audit/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/torus-tools%2Fseo_audit/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28585515,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-19T20:45:59.482Z","status":"ssl_error","status_checked_at":"2026-01-19T20:45:41.500Z","response_time":67,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["audit","css","html","javascript","nodejs","site"],"created_at":"2024-09-24T19:39:07.142Z","updated_at":"2026-01-19T21:33:14.286Z","avatar_url":"https://github.com/torus-tools.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cimg src=\"https://github.com/arjan-tools/site/blob/master/img/arjan_audit_logo.svg\" alt=\"Arjan Localize\" width=\"200\" style=\"max-width:100%;\"\u003e\n\n[![License](http://img.shields.io/:license-mit-blue.svg?style=flat-square)](http://gkpty.mit-license.org)\n\n# Arjan Audit\nArjan audit is a simple node module that helps automate the auditing process of static sites during the dev process using Google’s lighthouse 6. Often times when building a site, the page speed test is one of the last things we do. To avoid any surprise surprise, you can use arjan audit in your dev process or even integrate it into your tests.\n\n## How it works\nArjan audit  uses [express](https://expressjs.com/) to serve your site and google [chrome-launcher](https://github.com/GoogleChrome/chrome-launcher) to make a headless launch of google chrome and retrieve the audits from lighthouse 6. Arjan then parses the results returned by lighthouse and return an organized subset of the results. When used from the CLI, arjan returns a neatly formatted report. \n\n\n## Getting Started \n1. install the arjan CLI globally. `npm i -g arjan-cli`\n2. inside your proejct direcotry, initialize arja `arjan init`\n3. run an audit `arjan audit`\n\n## CLI Command\n\n    USAGE\n      $ arjan audit\n    \n    OPTIONS\n      -d, --dir=dir              Directory path to serve. default is root (relative to the path in which you run the command)\n    \n      -f, --file=file            Path of the page you want to audit. default is index.html\n    \n      -p, --port=port            Port used for the test server. Default is 8080.\n    \n      -t, --threshold=threshold  Integer value from 0 to 1 that represents what you consider to be an acceptable lighthouse score for your site. Its very similar to what you would consider an acceptable school test grade.\n\n## Programmatic use example\n    const Audit = require('arjan-audit')\n    Audit('./', 'index.html', 8080, .7)\n    .then(data=\u003e console.log(data))\n    .catch(err=\u003econsole.log(err))\n\n## API\n### main \n\n**description**:\n**params**: (dir, index, port, threshhold)\n\n     **dir**: string\n     **index**: string\n     **port**: int\n    **treshhold**: float: number between 0 and 1\n\n**returns**: Promise(resolve, reject)\n\n    **resolve**: string: formatted\n    **reject**: error\n\n\n## The Audit Report\n\nthe audit report is a subset of data from the JSON response of lighthouse 6. for more information on the parameters of lighthouse 6 see this [link](https://github.com/GoogleChrome/lighthouse/blob/master/docs/understanding-results.md#audit-properties)\n\n\n    {\n      \"lh5_score\":float,\n      \"lh6_score\":float,\n      \"main_metrics\":{\n        \"metric\":{\n          \"title\":\"string\",\n          \"score\":float,\n          \"description\":\"string\"\n        }\n      },\n      \"improvements\":{\n        \"improvement\":{\n          \"title\":\"title\",\n          \"score\":float,\n          \"description\":\"description\",\n          \"details\":{}\n        }\n      }\n    }\n\n## Lighthouse 6 score\n\nGoogle recently recalculated the score of what they consdier a healthy fast site. The new LCP metric was introduced and the score weights and metrics were changed. for more information check out Google’s [Web Vitals](https://web.dev/vitals/) \n\n| Audit                                                                  | Weight |\n| ---------------------------------------------------------------------- | ------ |\n| [First Contentful Paint](https://web.dev/first-contentful-paint/)      | 15%    |\n| [Speed Index](https://web.dev/speed-index/)                            | 15%    |\n| [Largest Contentful Paint](https://web.dev/lcp/)                       | 25%    |\n| [Time to Interactive](https://web.dev/interactive/)                    | 15%    |\n| [Total Blocking Time](https://web.dev/lighthouse-total-blocking-time/) | 25%    |\n| [Cumulative Layout Shift](https://web.dev/cls/)                        | 5%     |\n\n### For more info read the [docs](https://arjan.tools/docs) \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftorus-tools%2Fseo_audit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftorus-tools%2Fseo_audit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftorus-tools%2Fseo_audit/lists"}