{
  "url": "https://telipot.com/catalog/capabilities/news.search",
  "id": "news.search",
  "description": "Stories and comments on a news site that match a query",
  "platform": "news",
  "providers": [
    {
      "slug": "hackernews",
      "name": "Hacker News"
    }
  ],
  "tasks": 1,
  "taskPages": [
    {
      "id": "hackernews.news.search",
      "name": "Hacker News stories by query, ranked by relevance",
      "provider": {
        "slug": "hackernews",
        "name": "Hacker News"
      },
      "capability": "news.search",
      "platform": "news",
      "kind": "data",
      "tier": "core",
      "identity": "public",
      "identityLabel": "No account",
      "price": {
        "amount": "Free",
        "state": "free",
        "label": "Free",
        "detail": "Free · no account needed",
        "type": "free"
      },
      "providers": 1,
      "retention": "standard",
      "runsOn": "free",
      "live": true,
      "summary": "Search Hacker News stories and comments",
      "method": "GET",
      "path": "/search",
      "host": "https://hn.algolia.com/api/v1",
      "docsUrl": "https://hn.algolia.com/api",
      "auth": {
        "scheme": "public",
        "label": "public · no credential",
        "short": "public"
      },
      "requiredScopes": [],
      "verification": {
        "state": "verified",
        "label": "Verified on 2026-10-05",
        "detail": "We ran a real request and checked the answer. This is a spot check, not a success rate."
      },
      "input": [
        {
          "name": "query",
          "location": "queryParams",
          "type": "string",
          "required": true,
          "constraints": []
        },
        {
          "name": "tags",
          "location": "queryParams",
          "type": "string",
          "required": false,
          "constraints": [
            "one of \"story\", \"comment\"",
            "default \"story\""
          ]
        },
        {
          "name": "hitsPerPage",
          "location": "queryParams",
          "type": "integer",
          "required": false,
          "constraints": [
            "1 to 50",
            "default 10"
          ]
        }
      ],
      "sampleInput": {
        "query": "agent tools",
        "hitsPerPage": 2
      },
      "inputSchema": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string",
            "examples": [
              "agent tools"
            ]
          },
          "tags": {
            "type": "string",
            "enum": [
              "story",
              "comment"
            ],
            "default": "story"
          },
          "hitsPerPage": {
            "type": "integer",
            "default": 10,
            "minimum": 1,
            "maximum": 50
          }
        },
        "required": [
          "query"
        ],
        "additionalProperties": false
      },
      "output": [
        {
          "name": "hits",
          "type": "object[]"
        },
        {
          "name": "hitsPerPage",
          "type": "integer"
        },
        {
          "name": "nbHits",
          "type": "integer"
        },
        {
          "name": "nbPages",
          "type": "integer"
        },
        {
          "name": "page",
          "type": "integer"
        },
        {
          "name": "params",
          "type": "string"
        },
        {
          "name": "processingTimeMS",
          "type": "integer"
        },
        {
          "name": "query",
          "type": "string"
        }
      ],
      "outputSchema": {
        "type": "object",
        "required": [
          "hits",
          "hitsPerPage",
          "nbHits",
          "nbPages",
          "page",
          "query"
        ],
        "properties": {
          "hits": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "objectID",
                "author",
                "created_at",
                "created_at_i",
                "_tags"
              ],
              "properties": {
                "objectID": {
                  "type": "string"
                },
                "title": {
                  "type": "string"
                },
                "url": {
                  "type": "string"
                },
                "author": {
                  "type": "string"
                },
                "points": {
                  "type": [
                    "integer",
                    "null"
                  ]
                },
                "num_comments": {
                  "type": [
                    "integer",
                    "null"
                  ]
                },
                "story_id": {
                  "type": "integer"
                },
                "story_text": {
                  "type": "string"
                },
                "comment_text": {
                  "type": "string"
                },
                "created_at": {
                  "type": "string"
                },
                "created_at_i": {
                  "type": "integer"
                },
                "updated_at": {
                  "type": "string"
                },
                "_tags": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              }
            }
          },
          "hitsPerPage": {
            "type": "integer"
          },
          "nbHits": {
            "type": "integer"
          },
          "nbPages": {
            "type": "integer"
          },
          "page": {
            "type": "integer"
          },
          "params": {
            "type": "string"
          },
          "processingTimeMS": {
            "type": "integer"
          },
          "query": {
            "type": "string"
          }
        }
      },
      "example": {
        "file": "examples/hackernews.news.search.json",
        "json": {
          "hits": [
            {
              "_tags": [
                "story",
                "author_user"
              ],
              "author": "user",
              "created_at": "2026-07-09T15:45:17Z",
              "created_at_i": 1783611917,
              "num_comments": 40,
              "objectID": "48847834",
              "points": 96,
              "story_id": 48847834,
              "story_text": "Hey HN! We built a browser-based agent that runs inside an authenticated web app, watches how the app calls its own APIs, and automatically turns those into agent tools. You can think of it as an auto…",
              "title": "Show HN: Reverse-engineering web apps into agent tools",
              "updated_at": "2026-07-20T14:39:08Z"
            },
            {
              "_tags": [
                "story",
                "author_user"
              ],
              "author": "user",
              "created_at": "2026-03-24T06:31:15Z",
              "created_at_i": 1774333875,
              "num_comments": 8,
              "objectID": "47499242",
              "points": 50,
              "story_id": 47499242,
              "title": "Fast regex search: indexing text for agent tools",
              "updated_at": "2026-04-09T02:11:45Z",
              "url": "https://cursor.com/blog/fast-regex-search"
            }
          ],
          "hitsPerPage": 2,
          "nbHits": 69733,
          "nbPages": 500,
          "page": 0,
          "params": "query=agent+tools&hitsPerPage=2&advancedSyntax=true&analyticsTags=backend",
          "processingTimeMS": 36,
          "query": "agent tools"
        }
      },
      "commands": {
        "mode": "run",
        "cli": "telipot run hackernews.news.search \\\n  --input-json '{\"query\":\"agent tools\",\"hitsPerPage\":2}'",
        "http": "curl https://api.telipot.com/v1/tasks/hackernews.news.search/run \\\n  -H \"Authorization: Bearer $TELIPOT_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"query\":\"agent tools\",\"hitsPerPage\":2}'",
        "quote": "telipot run hackernews.news.search \\\n  --input-json '{\"query\":\"agent tools\",\"hitsPerPage\":2}' \\\n  --quote"
      },
      "siblings": []
    }
  ]
}