Merge Bookmarks API

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

Merge two or more Netscape bookmarks.html exports (Chrome, Firefox, Edge, Safari) into one bookmarks.html that any browser imports. Every link and folder is kept in file order; by default each file goes under its own top-level folder named after the file, and wrap_in_folders=false merges folders that share a name (both "Bookmarks bar" folders become one). dedupe keeps the first copy of each address, compared 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. An input with no bookmarks is reported and the rest still merge. Descriptions, icons and tags are not carried over, empty folders are not written, and no link is fetched.

Open the tool Try it

Request body

application/json

inputs

array required

The bookmarks.html file contents, one string per file, in the order they should appear. At least 2 with bookmarks, at most 20.
names

array optional

Optional file names, one per input, used to name each file's folder (the .html extension is dropped). Missing names become "File 1", "File 2"…
wrap_in_folders

boolean optional

Put each file under a top-level folder named after it. Default true. When false, folders with the same name at the same level are merged. Default true.
dedupe

boolean optional

Keep only the first copy of each address. Default false: every copy stays. Default false.
strip_tracking

boolean optional

When deduping, treat utm_*, fbclid and gclid parameters as noise. Default true. Default true.
ignore_fragment

boolean optional

When deduping, treat addresses that differ only by #fragment as the same page. Default true. Default true.

Example arguments

Verified

{
  "inputs": [
    "<!DOCTYPE NETSCAPE-Bookmark-file-1>\n<DL><p>\n    <DT><A HREF=\"https://example.com/\">Example</A>\n</DL><p>\n",
    "<!DOCTYPE NETSCAPE-Bookmark-file-1>\n<DL><p>\n    <DT><A HREF=\"https://example.org/\">Example Org</A>\n</DL><p>\n"
  ],
  "names": [
    "work.html",
    "home.html"
  ]
}

curl -X POST https://api.findutils.com/api/tools/merge-bookmarks/execute \
  -H "Content-Type: application/json" \
  -d '{
    "inputs": [
      "<!DOCTYPE NETSCAPE-Bookmark-file-1>\n<DL><p>\n    <DT><A HREF=\"https://example.com/\">Example</A>\n</DL><p>\n",
      "<!DOCTYPE NETSCAPE-Bookmark-file-1>\n<DL><p>\n    <DT><A HREF=\"https://example.org/\">Example Org</A>\n</DL><p>\n"
    ],
    "names": [
      "work.html",
      "home.html"
    ]
  }'

const response = await fetch('https://api.findutils.com/api/tools/merge-bookmarks/execute', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({"inputs":["<!DOCTYPE NETSCAPE-Bookmark-file-1>\n<DL><p>\n    <DT><A HREF=\"https://example.com/\">Example</A>\n</DL><p>\n","<!DOCTYPE NETSCAPE-Bookmark-file-1>\n<DL><p>\n    <DT><A HREF=\"https://example.org/\">Example Org</A>\n</DL><p>\n"],"names":["work.html","home.html"]}),
});
const data = await response.json();

import requests

response = requests.post(
    "https://api.findutils.com/api/tools/merge-bookmarks/execute",
    json={"inputs":["<!DOCTYPE NETSCAPE-Bookmark-file-1>\n<DL><p>\n    <DT><A HREF=\"https://example.com/\">Example</A>\n</DL><p>\n","<!DOCTYPE NETSCAPE-Bookmark-file-1>\n<DL><p>\n    <DT><A HREF=\"https://example.org/\">Example Org</A>\n</DL><p>\n"],"names":["work.html","home.html"]},
)
data = response.json()

$ch = curl_init('https://api.findutils.com/api/tools/merge-bookmarks/execute');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => '{"inputs":["<!DOCTYPE NETSCAPE-Bookmark-file-1>\n<DL><p>\n    <DT><A HREF=\"https://example.com/\">Example</A>\n</DL><p>\n","<!DOCTYPE NETSCAPE-Bookmark-file-1>\n<DL><p>\n    <DT><A HREF=\"https://example.org/\">Example Org</A>\n</DL><p>\n"],"names":["work.html","home.html"]}',
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

Also an MCP tool

Call merge_bookmarks 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: merge-bookmarks
MCP name: merge_bookmarks
Category: Text
Machine-readable: openapi.json · markdown.md

Request body

Example arguments

More Text tools

More to explore