Safari Bookmarks To Html API

POST https://api.findutils.com/api/tools/safari-bookmarks-to-html/execute

Convert Safari's Bookmarks.plist (from ~/Library/Safari on a Mac or a backup of it) into a Netscape bookmarks.html that Chrome, Firefox, Edge and other browsers import. Reads the binary bplist00 file Safari writes, sent as base64 with input_encoding "base64", or an XML plist from plutil -convert xml1 as text. The WebBookmarkTypeList folders and WebBookmarkTypeLeaf bookmarks (URLString and URIDictionary.title) are walked in order: the BookmarksBar root becomes a "Favorites" folder marked as the toolbar folder, BookmarksMenu becomes "Bookmarks Menu", and the Reading List (com.apple.ReadingList) becomes a "Reading List" folder with each item's date added, unless include_reading_list is false. The History proxy entry is skipped, empty folders are left out unless include_empty_folders is true, and sync metadata, icons and Reading List preview text are not carried over. A plist that is not Safari's bookmarks file (an Info.plist, a .webloc) is refused with what it looks like. Nothing is fetched.

Needs an API key. Running a tool needs an API key. Keys are not for sale yet: ask for early access. About API keys

Open the tool Try it

Request body

application/json

input

string required

The Bookmarks.plist file: base64 of the file bytes (input_encoding "base64", needed for the binary form), or XML plist text.
input_encoding

string optional

"text" (default) for an XML plist, or "base64" for the file bytes, binary or XML. One of text · base64. Default "text".
include_reading_list

boolean optional

Write the Reading List as its own "Reading List" folder. Default true; false leaves those items out and counts them. Default true.
include_empty_folders

boolean optional

Also write folders that hold no bookmark. Default false: they are left out and counted. Default false.

Example arguments

Verified

{
  "input": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<plist version=\"1.0\">\n<dict>\n\t<key>Children</key>\n\t<array>\n\t\t<dict>\n\t\t\t<key>Children</key>\n\t\t\t<array>\n\t\t\t\t<dict>\n\t\t\t\t\t<key>URIDictionary</key>\n\t\t\t\t\t<dict>\n\t\t\t\t\t\t<key>title</key>\n\t\t\t\t\t\t<string>Example</string>\n\t\t\t\t\t</dict>\n\t\t\t\t\t<key>URLString</key>\n\t\t\t\t\t<string>https://example.com/</string>\n\t\t\t\t\t<key>WebBookmarkType</key>\n\t\t\t\t\t<string>WebBookmarkTypeLeaf</string>\n\t\t\t\t</dict>\n\t\t\t</array>\n\t\t\t<key>Title</key>\n\t\t\t<string>BookmarksBar</string>\n\t\t\t<key>WebBookmarkType</key>\n\t\t\t<string>WebBookmarkTypeList</string>\n\t\t</dict>\n\t</array>\n\t<key>WebBookmarkType</key>\n\t<string>WebBookmarkTypeList</string>\n</dict>\n</plist>\n"
}

curl -X POST https://api.findutils.com/api/tools/safari-bookmarks-to-html/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<plist version=\"1.0\">\n<dict>\n\t<key>Children</key>\n\t<array>\n\t\t<dict>\n\t\t\t<key>Children</key>\n\t\t\t<array>\n\t\t\t\t<dict>\n\t\t\t\t\t<key>URIDictionary</key>\n\t\t\t\t\t<dict>\n\t\t\t\t\t\t<key>title</key>\n\t\t\t\t\t\t<string>Example</string>\n\t\t\t\t\t</dict>\n\t\t\t\t\t<key>URLString</key>\n\t\t\t\t\t<string>https://example.com/</string>\n\t\t\t\t\t<key>WebBookmarkType</key>\n\t\t\t\t\t<string>WebBookmarkTypeLeaf</string>\n\t\t\t\t</dict>\n\t\t\t</array>\n\t\t\t<key>Title</key>\n\t\t\t<string>BookmarksBar</string>\n\t\t\t<key>WebBookmarkType</key>\n\t\t\t<string>WebBookmarkTypeList</string>\n\t\t</dict>\n\t</array>\n\t<key>WebBookmarkType</key>\n\t<string>WebBookmarkTypeList</string>\n</dict>\n</plist>\n"
  }'

const response = await fetch('https://api.findutils.com/api/tools/safari-bookmarks-to-html/execute', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', Authorization: 'Bearer YOUR_API_KEY' },
  body: JSON.stringify({"input":"<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<plist version=\"1.0\">\n<dict>\n\t<key>Children</key>\n\t<array>\n\t\t<dict>\n\t\t\t<key>Children</key>\n\t\t\t<array>\n\t\t\t\t<dict>\n\t\t\t\t\t<key>URIDictionary</key>\n\t\t\t\t\t<dict>\n\t\t\t\t\t\t<key>title</key>\n\t\t\t\t\t\t<string>Example</string>\n\t\t\t\t\t</dict>\n\t\t\t\t\t<key>URLString</key>\n\t\t\t\t\t<string>https://example.com/</string>\n\t\t\t\t\t<key>WebBookmarkType</key>\n\t\t\t\t\t<string>WebBookmarkTypeLeaf</string>\n\t\t\t\t</dict>\n\t\t\t</array>\n\t\t\t<key>Title</key>\n\t\t\t<string>BookmarksBar</string>\n\t\t\t<key>WebBookmarkType</key>\n\t\t\t<string>WebBookmarkTypeList</string>\n\t\t</dict>\n\t</array>\n\t<key>WebBookmarkType</key>\n\t<string>WebBookmarkTypeList</string>\n</dict>\n</plist>\n"}),
});
const data = await response.json();

import requests

response = requests.post(
    "https://api.findutils.com/api/tools/safari-bookmarks-to-html/execute",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"input":"<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<plist version=\"1.0\">\n<dict>\n\t<key>Children</key>\n\t<array>\n\t\t<dict>\n\t\t\t<key>Children</key>\n\t\t\t<array>\n\t\t\t\t<dict>\n\t\t\t\t\t<key>URIDictionary</key>\n\t\t\t\t\t<dict>\n\t\t\t\t\t\t<key>title</key>\n\t\t\t\t\t\t<string>Example</string>\n\t\t\t\t\t</dict>\n\t\t\t\t\t<key>URLString</key>\n\t\t\t\t\t<string>https://example.com/</string>\n\t\t\t\t\t<key>WebBookmarkType</key>\n\t\t\t\t\t<string>WebBookmarkTypeLeaf</string>\n\t\t\t\t</dict>\n\t\t\t</array>\n\t\t\t<key>Title</key>\n\t\t\t<string>BookmarksBar</string>\n\t\t\t<key>WebBookmarkType</key>\n\t\t\t<string>WebBookmarkTypeList</string>\n\t\t</dict>\n\t</array>\n\t<key>WebBookmarkType</key>\n\t<string>WebBookmarkTypeList</string>\n</dict>\n</plist>\n"},
)
data = response.json()

$ch = curl_init('https://api.findutils.com/api/tools/safari-bookmarks-to-html/execute');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json', 'Authorization: Bearer YOUR_API_KEY'],
    CURLOPT_POSTFIELDS => '{"input":"<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<plist version=\"1.0\">\n<dict>\n\t<key>Children</key>\n\t<array>\n\t\t<dict>\n\t\t\t<key>Children</key>\n\t\t\t<array>\n\t\t\t\t<dict>\n\t\t\t\t\t<key>URIDictionary</key>\n\t\t\t\t\t<dict>\n\t\t\t\t\t\t<key>title</key>\n\t\t\t\t\t\t<string>Example</string>\n\t\t\t\t\t</dict>\n\t\t\t\t\t<key>URLString</key>\n\t\t\t\t\t<string>https://example.com/</string>\n\t\t\t\t\t<key>WebBookmarkType</key>\n\t\t\t\t\t<string>WebBookmarkTypeLeaf</string>\n\t\t\t\t</dict>\n\t\t\t</array>\n\t\t\t<key>Title</key>\n\t\t\t<string>BookmarksBar</string>\n\t\t\t<key>WebBookmarkType</key>\n\t\t\t<string>WebBookmarkTypeList</string>\n\t\t</dict>\n\t</array>\n\t<key>WebBookmarkType</key>\n\t<string>WebBookmarkTypeList</string>\n</dict>\n</plist>\n"}',
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

Also an MCP tool

Call safari_bookmarks_to_html 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: API key
REST id: safari-bookmarks-to-html
MCP name: safari_bookmarks_to_html
Category: Text
Machine-readable: openapi.json · markdown.md

Request body

Example arguments

More Text tools

More to explore