Get a Nekoweb site's title, domain, views, followers, update count and creation/update dates.

Without 'site', returns the site that the configured API key belongs to. With 'site', looks up any public Nekoweb site (no API key needed).

Examples:

• "How many views does my site have?" -> {}

• "How popular is fairfruit.nekoweb.org?" -> { site: "fairfruit.nekoweb.org" } Use nekoweb_list_sites to see every site on the account.

List every site on the Nekoweb account that owns the API key, with domain, title, views, followers, dates and the folder that holds each site's files. The main site is marked.

Call this first to learn the folder to use in file paths, e.g. '/mysite.nekoweb.org'.

Use nekoweb_get_site_info for a single site.

Show the account's current API rate limits: 'general' (most file operations), 'big_uploads' (chunked uploads over 95MB) and 'zip' (zip imports).

Each limit has the maximum, how many requests remain, and when the counter resets. Call this before bulk operations or after a 429 error.

List the files and folders inside a folder of your Nekoweb site, sorted by path.

Set recursive=true to walk subfolders too (up to max_depth levels; each subfolder costs one API request against the rate limit, capped at 25 per call). Results are paginated with limit/offset.

Examples:

• "What's on my site?" -> { path: "/" }

• "Find every image on my site" -> { path: "/mysite.nekoweb.org/assets", recursive: true }

Read the raw source of a file on your Nekoweb site (SSI directives in .html files are returned as written, not rendered).

Text files are returned as text, paginated by character offset. Images up to 5.0 MB are returned as images. Other binaries return only their size.

Examples:

• "Show me my homepage HTML" -> { path: "/mysite.nekoweb.org/index.html" }

• "Read the rest of the stylesheet" -> { path: "/mysite.nekoweb.org/style.css", offset: 20000 }

Create a new empty file or a new folder on your Nekoweb site. Fails if something already exists at that path.

To create a file with content in one step, use nekoweb_write_file instead.

Examples:

• "Make a blog folder" -> { path: "/mysite.nekoweb.org/blog", is_folder: true }

• "Create an empty robots.txt" -> { path: "/mysite.nekoweb.org/robots.txt", is_folder: false }

Write text content to a file on your Nekoweb site, creating it or replacing its entire content.

mode='create_or_overwrite' (default) uploads the file whether or not it exists; the parent folder must already exist (create it with nekoweb_create). mode='edit_existing' only changes a file that already exists.

Always send the complete new file content; there is no partial update. For binary or local files, use nekoweb_upload_file.

Examples:

• "Change my homepage title" -> read it with nekoweb_read_file, then { path: "/mysite.nekoweb.org/index.html", content: "" }

• "Add a stylesheet" -> { path: "/mysite.nekoweb.org/css/style.css", content: "body { ... }" }

Permanently delete a file or a folder (including everything inside it) from your Nekoweb site. This cannot be undone.

Example: "Remove the old drafts folder" -> { path: "/mysite.nekoweb.org/drafts" }

Rename or move a file or folder on your Nekoweb site. Both are full paths from your file root; the destination's parent folder must exist.

Examples:

• "Rename about.html to about-me.html" -> { from: "/mysite.nekoweb.org/about.html", to: "/mysite.nekoweb.org/about-me.html" }

• "Move logo.png into the images folder" -> { from: "/mysite.nekoweb.org/logo.png", to: "/mysite.nekoweb.org/images/logo.png" }

Upload one or more files (any type, e.g. images, fonts, HTML) into a folder of your Nekoweb site. Existing files with the same name are overwritten.

Provide files as local_paths (files on this machine) and/or as base64 'files'. Files over 95MB are sent automatically with Nekoweb's chunked big-file upload. For plain text content, nekoweb_write_file is simpler.

Examples:

• "Upload my banner" -> { folder: "/mysite.nekoweb.org/images", local_paths: ["C:/Users/me/banner.png"] }

• "Add this favicon" -> { folder: "/mysite.nekoweb.org", files: [{ name: "favicon.ico", content_base64: "AAABAA..." }] }

Upload a .zip archive and extract it into a folder of your Nekoweb site, e.g. to deploy a whole site at once. Extracted files overwrite existing files with the same paths.

The 'zip' rate limit is strict (often 1 import per period); check nekoweb_get_limits first when unsure.

Example: "Deploy my built site" -> { zip_local_path: "C:/projects/site/dist.zip", folder: "/mysite.nekoweb.org" }