seoscoreapi 1.0.0

package/LICENSE

@@ -0,0 +1,17 @@
+MIT License
+
+Copyright (c) 2026 SEO Score API
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.

package/README.md

@@ -0,0 +1,43 @@
+# seoscoreapi
+
+Node.js client for [SEO Score API](https://seoscoreapi.com) — audit any URL for SEO issues with one function call.
+
+## Install
+
+```bash
+npm install seoscoreapi
+```
+
+## Quick Start
+
+```javascript
+const { signup, audit } = require("seoscoreapi");
+
+// Get a free API key (5 audits/day)
+const key = await signup("you@example.com");
+
+// Audit any URL
+const result = await audit("https://example.com", key);
+console.log(`Score: ${result.score}/100 (${result.grade})`);
+
+result.priorities.forEach(p =>
+  console.log(`  [${p.severity}] ${p.issue}`)
+);
+```
+
+## API
+
+| Function | Description |
+|----------|-------------|
+| `signup(email)` | Get a free API key |
+| `audit(url, apiKey)` | Run SEO audit |
+| `batchAudit(urls, apiKey)` | Audit multiple URLs (paid) |
+| `usage(apiKey)` | Check usage/limits |
+| `addMonitor(url, apiKey)` | Set up monitoring (paid) |
+| `reportUrl(domain)` | Get shareable report URL |
+
+## Links
+
+- [Website & Demo](https://seoscoreapi.com)
+- [API Docs](https://seoscoreapi.com/docs)
+- [GitHub Action](https://github.com/SeoScoreAPI/seo-audit-action)

package/index.js

@@ -0,0 +1,92 @@
+/**
+ * SEO Score API - Node.js Client
+ * Audit any URL for SEO issues with one function call.
+ * https://seoscoreapi.com
+ */
+
+const BASE_URL = "https://seoscoreapi.com";
+
+async function _fetch(path, options = {}) {
+  const url = `${BASE_URL}${path}`;
+  const res = await fetch(url, options);
+  if (!res.ok) {
+    const body = await res.json().catch(() => ({}));
+    throw new Error(body.detail || `HTTP ${res.status}`);
+  }
+  return res.json();
+}
+
+/**
+ * Sign up for a free API key.
+ * @param {string} email
+ * @returns {Promise<string>} The API key (save it — shown only once)
+ */
+async function signup(email) {
+  const data = await _fetch("/signup", {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ email }),
+  });
+  return data.api_key;
+}
+
+/**
+ * Run an SEO audit on a URL.
+ * @param {string} url - URL to audit
+ * @param {string} apiKey - Your API key
+ * @returns {Promise<Object>} Audit result with score, grade, checks, priorities
+ */
+async function audit(url, apiKey) {
+  return _fetch(`/audit?url=${encodeURIComponent(url)}`, {
+    headers: { "X-API-Key": apiKey },
+  });
+}
+
+/**
+ * Audit multiple URLs (paid plans only).
+ * @param {string[]} urls
+ * @param {string} apiKey
+ * @returns {Promise<Object>}
+ */
+async function batchAudit(urls, apiKey) {
+  return _fetch("/audit/batch", {
+    method: "POST",
+    headers: { "Content-Type": "application/json", "X-API-Key": apiKey },
+    body: JSON.stringify({ urls }),
+  });
+}
+
+/**
+ * Check your API usage and limits.
+ * @param {string} apiKey
+ * @returns {Promise<Object>}
+ */
+async function usage(apiKey) {
+  return _fetch("/usage", { headers: { "X-API-Key": apiKey } });
+}
+
+/**
+ * Set up score monitoring for a URL (paid plans only).
+ * @param {string} url
+ * @param {string} apiKey
+ * @param {string} [frequency="daily"]
+ * @returns {Promise<Object>}
+ */
+async function addMonitor(url, apiKey, frequency = "daily") {
+  return _fetch("/monitors", {
+    method: "POST",
+    headers: { "Content-Type": "application/json", "X-API-Key": apiKey },
+    body: JSON.stringify({ url, frequency }),
+  });
+}
+
+/**
+ * Get shareable report URL for a domain.
+ * @param {string} domain
+ * @returns {string}
+ */
+function reportUrl(domain) {
+  return `${BASE_URL}/report/${domain}`;
+}
+
+module.exports = { signup, audit, batchAudit, usage, addMonitor, reportUrl };

package/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "seoscoreapi",
+  "version": "1.0.0",
+  "description": "Node.js client for SEO Score API — audit any URL for SEO issues with one function call",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "keywords": ["seo", "audit", "api", "seo-score", "website-audit", "seo-checker", "seo-api"],
+  "author": "SEO Score API <info@seoscoreapi.com>",
+  "license": "MIT",
+  "homepage": "https://seoscoreapi.com",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/SeoScoreAPI/examples"
+  }
+}