Bookmarks Diff API

POST https://api.findutils.com/api/tools/bookmarks-diff/execute

Compare two Netscape bookmarks.html exports (before and after) and list the links that were added, removed, or changed. Links are matched by address the way dedupe_bookmarks compares them: host case, default port and trailing slash folded, and by default utm_* / fbclid / gclid parameters and the #fragment ignored. A match is "changed" when its title differs or, with compare_folders (default true), when it sits in a different folder. Returns counts, one entry per difference, a CSV report, and the added and removed links as importable bookmarks.html files. An address saved twice on one side is compared once, by its first copy. No link is fetched.

Open the tool Try it

Request body

application/json

before

string required

The older Netscape bookmarks HTML.
after

string required

The newer Netscape bookmarks HTML.
strip_tracking

boolean optional

Treat utm_*, fbclid and gclid parameters as noise when matching. Default true. Default true.
ignore_fragment

boolean optional

Treat addresses that differ only by #fragment as the same page. Default true. Default true.
compare_folders

boolean optional

Count a link that moved to another folder as changed. Default true. Default true.

Example arguments

Verified

{
  "before": "<!DOCTYPE NETSCAPE-Bookmark-file-1>\n<DL><p>\n    <DT><A HREF=\"https://example.com/\">Example</A>\n    <DT><A HREF=\"https://old.example/\">Old</A>\n</DL><p>\n",
  "after": "<!DOCTYPE NETSCAPE-Bookmark-file-1>\n<DL><p>\n    <DT><A HREF=\"https://example.com/\">Example (renamed)</A>\n    <DT><A HREF=\"https://new.example/\">New</A>\n</DL><p>\n"
}

curl -X POST https://api.findutils.com/api/tools/bookmarks-diff/execute \
  -H "Content-Type: application/json" \
  -d '{
    "before": "<!DOCTYPE NETSCAPE-Bookmark-file-1>\n<DL><p>\n    <DT><A HREF=\"https://example.com/\">Example</A>\n    <DT><A HREF=\"https://old.example/\">Old</A>\n</DL><p>\n",
    "after": "<!DOCTYPE NETSCAPE-Bookmark-file-1>\n<DL><p>\n    <DT><A HREF=\"https://example.com/\">Example (renamed)</A>\n    <DT><A HREF=\"https://new.example/\">New</A>\n</DL><p>\n"
  }'

const response = await fetch('https://api.findutils.com/api/tools/bookmarks-diff/execute', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({"before":"<!DOCTYPE NETSCAPE-Bookmark-file-1>\n<DL><p>\n    <DT><A HREF=\"https://example.com/\">Example</A>\n    <DT><A HREF=\"https://old.example/\">Old</A>\n</DL><p>\n","after":"<!DOCTYPE NETSCAPE-Bookmark-file-1>\n<DL><p>\n    <DT><A HREF=\"https://example.com/\">Example (renamed)</A>\n    <DT><A HREF=\"https://new.example/\">New</A>\n</DL><p>\n"}),
});
const data = await response.json();

import requests

response = requests.post(
    "https://api.findutils.com/api/tools/bookmarks-diff/execute",
    json={"before":"<!DOCTYPE NETSCAPE-Bookmark-file-1>\n<DL><p>\n    <DT><A HREF=\"https://example.com/\">Example</A>\n    <DT><A HREF=\"https://old.example/\">Old</A>\n</DL><p>\n","after":"<!DOCTYPE NETSCAPE-Bookmark-file-1>\n<DL><p>\n    <DT><A HREF=\"https://example.com/\">Example (renamed)</A>\n    <DT><A HREF=\"https://new.example/\">New</A>\n</DL><p>\n"},
)
data = response.json()

$ch = curl_init('https://api.findutils.com/api/tools/bookmarks-diff/execute');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => '{"before":"<!DOCTYPE NETSCAPE-Bookmark-file-1>\n<DL><p>\n    <DT><A HREF=\"https://example.com/\">Example</A>\n    <DT><A HREF=\"https://old.example/\">Old</A>\n</DL><p>\n","after":"<!DOCTYPE NETSCAPE-Bookmark-file-1>\n<DL><p>\n    <DT><A HREF=\"https://example.com/\">Example (renamed)</A>\n    <DT><A HREF=\"https://new.example/\">New</A>\n</DL><p>\n"}',
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

Also an MCP tool

Call bookmarks_diff from Claude, Cursor or any MCP client. Same arguments, same output.

https://mcp.findutils.com

MCP reference

Rate limit: 60 a minute, per IP
Auth: None
REST id: bookmarks-diff
MCP name: bookmarks_diff
Category: Text
Machine-readable: openapi.json · markdown.md

Request body

Example arguments

More Text tools

More to explore