Automation

Command Line Tools

An executable for batch processing and content pipeline integrations.

Our CLI makes it easier to work with locally-accessible files or web pages containing structured data. Similar to the playground, it provides subcommands for validation and syntax conversion, and can be used by humans, machines, or agents.

Installation

For each release, we provide precompiled binaries for different operating systems and architectures. Double check your system requirements, and then use one of the methods below before continuing to verify your installation.

Requires a 64-bit Linux distribution with glibc 2.17 or newer.

Install via Homebrew
$ 
brew install curiolane/tap/schemamarkup
Install via Terminal
$ 
curl -LO https://releases.curiolane.com/schemamarkup/1.202505.0/schemamarkup-1.202505.0-linux-amd64.tar.gz
$ 
echo "def456ghi789jkl012mno34567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef  schemamarkup-1.202505.0-linux-amd64.tar.gz" | shasum -a 256 --check
$ 
tar -xzf schemamarkup-1.202505.0-linux-amd64.tar.gz
$ 
sudo mv schemamarkup-1.202505.0-linux-amd64/schemamarkup /usr/local/bin/

Verify Installation

Once installed, execute the schemamarkup command and verify that it prints some basic information.

$ 
schemamarkup --version
cli version=1.202505.0
cli/build time=2024-06-30T01:02:03Z node=unknown
cli/runtime os=linux arch=amd64

If you see an error message (or no output at all), check some of the common problems below.

Authentication

If you are on a paid plan, authenticate using an Access Token for additional features and usage limits. The token may be set using one of the following methods, optionally including the Bearer prefix. Remember: tokens are sensitive and must be kept secret and handled securely.

  • SCHEMAMARKUP_API_TOKEN=cln... environment variable with sensitive value.
  • --api-token=cln... global flag with sensitive value.
  • --api-token=@path/to/token.txt global flag with sensitive value read from file path.

If you use the --api-token global flag, be sure to include it before the subcommand name and flags.

schemamarkup --api-token '{ACCESS_TOKEN}' ...

Commands

  • export — Tidy or convert a document to alternative RDF encodings.
  • mcp — Run a local Model Context Protocol Server for agent-focused workflows.
  • process — Process a document and return an annotated dataset and messages.
  • validate — Validate a document and return validation messages with source offsets.

Global Flags

  • string