Cosense icon

Cosense

Read and write pages in Cosense (formerly Scrapbox)

Overview

This node integrates with Cosense (formerly Scrapbox) to search page titles within a specified project. It allows users to retrieve a list of page titles filtered by an optional keyword query, with control over the maximum number of results returned. This is useful for quickly finding relevant pages in large projects or for building workflows that need to process or analyze specific pages based on their titles.

Practical examples:

  • Searching for all page titles containing the word "meeting" to generate a summary report.
  • Listing up to 1000 page titles in a project to feed into another automation step for further processing.
  • Filtering page titles by a keyword to find documentation pages related to a particular feature.

Properties

Name Meaning
Project Name The name of your Cosense/Scrapbox project where the page titles will be searched.
Title Query Optional keyword to filter page titles. If left empty, all page titles in the project are returned.
Limit Maximum number of page titles to return. Must be between 1 and 1000. Defaults to 50.

Output

The output is an array of JSON objects, each representing a page title matching the search criteria. Each object corresponds to one page title found in the project.

  • The json field contains the page title data as returned by the Cosense API client.
  • The output does not include binary data.

Example output structure (simplified):

[
  {
    "json": {
      "title": "Page Title 1",
      "id": "pageId1",
      "otherMetadata": "..."
    }
  },
  {
    "json": {
      "title": "Page Title 2",
      "id": "pageId2",
      "otherMetadata": "..."
    }
  }
]

Dependencies

  • Requires access to the Cosense API via an API client.
  • Optionally uses an API key credential for authentication if configured.
  • No additional environment variables are explicitly required beyond standard n8n credential setup for the Cosense API.

Troubleshooting

  • Empty results: If no page titles are returned, verify that the project name is correct and that the optional title query matches existing page titles.
  • API errors: Errors from the Cosense API (e.g., authentication failures, rate limits) will be thrown. Ensure valid API credentials are provided and that the project exists.
  • Limit out of range: The limit must be between 1 and 1000. Setting a value outside this range may cause errors or unexpected behavior.
  • Network issues: Connectivity problems can cause request failures; check network access to the Cosense API endpoint.

Links and References

Discussion