aiskillstore/marketplace / skills/0nl1n1n/sitemapkit
sitemapkit
FlaggedDiscover and extract sitemaps from any website using SitemapKit. Use this skill whenever the user wants to find pages on a website, get a list of URLs from a domain, audit a site's structure, crawl a sitemap, check what pages exist on a site, or do anything involving sitemaps or site URL discovery — even if they don't explicitly say "sitemap". Requires the sitemapkit MCP server configured with a valid SITEMAPKIT_API_KEY.
| File | Kind | Size |
|---|---|---|
| .gitignore | other | 25 B |
| LICENSE | other | 1.0 KB |
| README.md | markdown | 3.0 KB |
| SKILL.md | skill md | 3.3 KB |
| package-lock.json | manifest | 56.6 KB |
| package.json | manifest | 1.1 KB |
| skill-report.json | config | 210.7 KB |
| src/index.ts | script | 7.0 KB |
| tsconfig.json | config | 224 B |
src/index.ts
View on GitHub#!/usr/bin/env node
import { Server } from "@modelcontextprotocol/sdk/server/index.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import {
CallToolRequestSchema,
ListToolsRequestSchema,
Tool,
} from "@modelcontextprotocol/sdk/types.js";
const API_BASE = "https://app.sitemapkit.com/api/v1/sitemap";
function getApiKey(): string {
const key = process.env.SITEMAPKIT_API_KEY;
if (!key) {
throw new Error(
"SITEMAPKIT_API_KEY environment variable is not set. " +
"Get your API key at https://app.sitemapkit.com/settings/api"
);
}
return key;
}
async function callApi<T>(
endpoint: string,
body: Record<string, unknown>
): Promise<{ data: T; meta: Record<string, unknown> }> {
const apiKey = getApiKey();
const res = await fetch(`${API_BASE}/${endpoint}`, {
method: "POST",
headers: {
"Content-Type": "application/json",
"x-api-key": apiKey,
},
body: JSON.stringify(body),
});
const json = await res.json() as Record<string, unknown>;
if (!res.ok) {
const error = json.error as string ?? "Unknown error";
const message = json.message as string | undefined;
const upgrade = json.upgrade as string | undefined;
let msg = `SitemapKit API error (${res.status}): ${error}`;
if (message) msg += `\n${message}`;
if (upgrade) msg += `\nUpgrade at: ${upgrade}`;
throw new Error(msg);
}
return { data: json.data as T, meta: json.meta as Record<string, unknown> };
}
type SitemapEntry = {
loc: string;
lastmod?: string;
changefreq?: string;
priority?: string;
};
type DiscoverResult = {
domain: string;
sitemaps: string[];
source: string[];
};
type ExtractResult = {
sitemapUrl: string;
urls: SitemapEntry[];
totalUrls: number;
sitemapsProcessed: number;
truncated: boolean;
};
type FullResult = {
domain: string;
sitemapsDiscovered: number;
sitemapsProcessed: number;
urls: SitemapEntry[];
totalUrls: number;
truncated: boolean;
sources: string[];
};
const TOOLS: Tool[] = [
{
name: "discover_sitemaps",
description:
"Find all sitemap files for a given domain by checking robots.txt, common paths, and sitemap indexes. " +
"Returns a list of sitemap URLs. Use this first to understand a site's sitemap structure.",
inputSchema: {
type: "object",
properties: {
url: {
type: "string",
description:
"The domain to check, e.g. 'https://example.com'. Only the domain is used — path is ignored.",
},
},
required: ["url"],
},
},
{
name: "extract_sitemap",
description:
"Extract all URLs from a specific sitemap file (including sitemap indexes that link to child sitemaps). " +
"Returns URL entries with optional lastmod, changefreq, and priority metadata.",
inputSchema: {
type: "object",
properties: {
url: {
type: "string",
description: "The full URL of the sitemap file, e.g. 'https://example.com/sitemap.xml'.",
},
max_urls: {
type: "number",
description: "Maximum number of URLs to return. Defaults to 1000. Max allowed by your plan.",
default: 1000,
},
},
required: ["url"],
},
},
{
name: "full_crawl",
description:
"Discover all sitemaps for a domain and extract every URL across all of them in one call. " +
"This is the most convenient tool when you want the complete URL list for a site. " +
"Returns deduplicated URLs with metadata.",
inputSchema: {
type: "object",
properties: {
url: {
type: "string",
description: "The domain to crawl, e.g. 'https://example.com'.",
},
max_urls: {
type: "number",
description: "Maximum number of URLs to return. Defaults to 1000. Max allowed by your plan.",
default: 1000,
},
},
required: ["url"],
},
},
];
const server = new Server(
{ name: "sitemapkit-mcp", version: "1.1.0" },
{ capabilities: { tools: {} } }
);
server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS }));
server.setRequestHandler(CallToolRequestSchema, async (request) => {
const { name, arguments: args } = request.params;
try {
if (name === "discover_sitemaps") {
const url = args?.url as string;
const { data, meta } = await callApi<DiscoverResult>("discover", { url });
const quota = meta?.quota as { remaining: number; limit: number } | undefined;
let text = `Found ${data.sitemaps.length} sitemap(s) for ${data.domain}\n`;
text += `Discovery methods: ${data.source.join(", ")}\n\n`;
text += data.sitemaps.map((s) => `• ${s}`).join("\n");
if (quota) text += `\n\nQuota: ${quota.remaining} requests remaining this month`;
return { content: [{ type: "text", text }] };
}
if (name === "extract_sitemap") {
const url = args?.url as string;
const maxUrls = (args?.max_urls as number | undefined) ?? 1000;
const { data, meta } = await callApi<ExtractResult>("extract", { url, maxUrls });
const quota = meta?.quota as { remaining: number; limit: number } | undefined;
let text = `Extracted ${data.totalUrls} URL(s) from ${data.sitemapUrl}\n`;
text += `Sitemaps processed: ${data.sitemapsProcessed}`;
if (data.truncated) text += ` (truncated at ${maxUrls})`;
text += "\n\n";
text += data.urls.map((u) => {
let line = u.loc;
if (u.lastmod) line += ` [lastmod: ${u.lastmod}]`;
return line;
}).join("\n");
if (quota) text += `\n\nQuota: ${quota.remaining} requests remaining this month`;
return { content: [{ type: "text", text }] };
}
if (name === "full_crawl") {
const url = args?.url as string;
const maxUrls = (args?.max_urls as number | undefined) ?? 1000;
const { data, meta } = await callApi<FullResult>("full", { url, maxUrls });
const quota = meta?.quota as { remaining: number; limit: number } | undefined;
let text = `Full crawl of ${data.domain}\n`;
text += `Sitemaps discovered: ${data.sitemapsDiscovered} | Processed: ${data.sitemapsProcessed}\n`;
text += `Total URLs: ${data.totalUrls}`;
if (data.truncated) text += ` (truncated at ${maxUrls})`;
text += "\n\n";
text += data.urls.map((u) => {
let line = u.loc;
if (u.lastmod) line += ` [lastmod: ${u.lastmod}]`;
return line;
}).join("\n");
if (quota) text += `\n\nQuota: ${quota.remaining} requests remaining this month`;
return { content: [{ type: "text", text }] };
}
return {
content: [{ type: "text", text: `Unknown tool: ${name}` }],
isError: true,
};
} catch (error) {
const message = error instanceof Error ? error.message : String(error);
return {
content: [{ type: "text", text: message }],
isError: true,
};
}
});
async function main() {
const transport = new StdioServerTransport();
await server.connect(transport);
}
main().catch((err) => {
console.error(err);
process.exit(1);
});
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |