.do
Business

directories

Directory services and listings

directories

Directory and listing management for creating searchable catalogs of businesses, services, products, or people with categorization, ratings, and discovery features.

Overview

The directories primitive provides comprehensive directory management including hierarchical categories, advanced search, ratings and reviews, verification badges, and SEO-optimized listing pages for maximum discoverability.

Quick Example

import { directories } from 'sdk.do'

// Create directory
const directory = await directories.create({
  name: 'saas-tools',
  title: 'SaaS Tools Directory',
  categories: [
    { id: 'marketing', name: 'Marketing', parent: null },
    { id: 'email', name: 'Email Marketing', parent: 'marketing' },
    { id: 'analytics', name: 'Analytics', parent: null },
  ],
  fields: {
    name: 'string',
    description: 'text',
    website: 'url',
    pricing: 'string',
    features: 'array',
  },
})

// Add listing
await directories.addListing('saas-tools', {
  name: 'MailChimp',
  category: 'email',
  description: 'Email marketing platform',
  website: 'https://mailchimp.com',
  pricing: 'Free - $299/mo',
  features: ['Email campaigns', 'Automation', 'Analytics'],
})

// Search directory
const results = await directories.search('saas-tools', {
  query: 'email marketing',
  category: 'marketing',
  filters: { pricing: { lte: 100 } },
  sort: 'rating',
})

Core Capabilities

  • Hierarchical Categories - Nested category structures
  • Advanced Search - Full-text and faceted search
  • Ratings & Reviews - User feedback and ratings
  • Verification Badges - Verified listing status
  • SEO Optimization - Optimized for search engines

Access Methods

SDK

TypeScript/JavaScript library for directory management

await directories.addListing('saas-tools', { name: 'MailChimp', category: 'email' })

SDK Documentation

CLI

Command-line tool for directory operations

do directory add-listing saas-tools --name "MailChimp" --category email

CLI Documentation

API

REST/RPC endpoints for directory management

curl -X POST https://api.do/v1/directories/saas-tools/listings -d '{"name":"MailChimp"}'

API Documentation

MCP

Model Context Protocol for AI-driven directory management

Add MailChimp to the SaaS tools directory in the email marketing category

MCP Documentation