Skip to main content

Export Intercom Help Center article URLs — ready to feed into AI tools like NotebookLM.

Project description

Intercom Docs Exporter

Export your Intercom Help Center article URLs into a single file. Filter by tags, collections, and publish state. Output as TXT or CSV.

Built to quickly feed help center docs into AI tools like NotebookLM.

Features

  • Filter articles by publish state, tags, and collections
  • Export as plain URL list (TXT) or with metadata (CSV)
  • Web interface for non-technical users
  • CLI for automation and scripting
  • Stateless: your API token is never stored

Quick Start (Web)

Visit intercom-docs-exporter.onrender.com and paste your Intercom API token.

Quick Start (CLI)

pip install intercom-docs-exporter

# Export all published articles
intercom-docs-exporter --token $INTERCOM_TOKEN

# Export with filters
intercom-docs-exporter --token $INTERCOM_TOKEN --include-tag Internal --format csv -o articles.csv

# List collections
intercom-docs-exporter --token $INTERCOM_TOKEN --list-collections

Examples

Feed your help center into NotebookLM:

# Export all published article URLs to a file
intercom-docs-exporter --token $INTERCOM_TOKEN -o urls.txt
# Upload urls.txt to NotebookLM as a source

Export only public-facing docs as CSV:

intercom-docs-exporter --token $INTERCOM_TOKEN \
  --exclude-tag Internal \
  --exclude-tag Draft \
  --format csv \
  -o public_articles.csv

Export a specific collection:

intercom-docs-exporter --token $INTERCOM_TOKEN \
  --collection "Getting Started" \
  -o getting_started.txt

Export everything except one collection:

intercom-docs-exporter --token $INTERCOM_TOKEN \
  --exclude-collection "Internal Docs" \
  --format csv \
  -o external.csv

Combine tag and collection filters:

intercom-docs-exporter --token $INTERCOM_TOKEN \
  --collection "API Reference" \
  --include-tag "v2" \
  --exclude-tag "deprecated" \
  -o api_v2.txt

Include draft articles too:

intercom-docs-exporter --token $INTERCOM_TOKEN --state both -o all_articles.txt

Help

intercom-docs-exporter --help
Option Description Default
--token Intercom API access token required
--state published, draft, or both published
--include-tag Only include articles with this tag (repeatable) all
--exclude-tag Exclude articles with this tag (repeatable) none
--collection Only include this collection (repeatable) all
--exclude-collection Exclude this collection (repeatable) none
--format txt or csv txt
-o, --output Output file path stdout
--list-collections List available collections and exit

Getting your API token:

  1. Go to your Intercom Developer Hub
  2. Select your app → Authentication
  3. Copy your access token

Your token is only used for the current request and is never stored.

Contributing

See CONTRIBUTING.md.

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

intercom_docs_exporter-0.4.0.tar.gz (21.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

intercom_docs_exporter-0.4.0-py3-none-any.whl (17.6 kB view details)

Uploaded Python 3

File details

Details for the file intercom_docs_exporter-0.4.0.tar.gz.

File metadata

  • Download URL: intercom_docs_exporter-0.4.0.tar.gz
  • Upload date:
  • Size: 21.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.8

File hashes

Hashes for intercom_docs_exporter-0.4.0.tar.gz
Algorithm Hash digest
SHA256 97d2a1647fc3fbdca7fe30b60b9de6429ae18b83e397574c41b5e488d43ee1da
MD5 e94211f69f3c920403ecbec21e5c675e
BLAKE2b-256 4e22533ba1f016c097091a84b85ca0e36ee45b7edbe83dea656dc0f712480140

See more details on using hashes here.

File details

Details for the file intercom_docs_exporter-0.4.0-py3-none-any.whl.

File metadata

File hashes

Hashes for intercom_docs_exporter-0.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 244fb29a652f73962a050562440b4f53169e4b490bb0791fb35380a796568f1f
MD5 7e4f2758c781ddfcedb7ef47e0d4e62f
BLAKE2b-256 7770e12e2532adcf8344d4a83cf538f64e0b6a333faffa1198d853eca4c88971

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page