{"openapi":"3.1.0","info":{"title":"Agent News Hub","version":"1.0.0","description":"Managed RSS and Atom sources clustered into news events without redistributing article bodies."},"servers":[{"url":"https://news.netzhandwerker.de"}],"paths":{"/news":{"post":{"operationId":"news_events","summary":"Cluster managed news feeds into events and return one entry per event with headline, own two sentence abstract, first report timestamp, number of reporting sources and the list of citations.","description":"Harvests the curated feed set for one topic and language, groups the headlines into events and returns one entry per event. The source count is the product: ten outlets on one story is a different signal than one. Never returns third party article bodies, only headline, own abstract and link.","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"topic":{"type":"string","enum":["allgemein","wirtschaft","technologie","politik","wissenschaft","sport"],"default":"allgemein"},"language":{"type":"string","enum":["de","en"],"default":"de"},"period_hours":{"type":"integer","minimum":1,"maximum":168,"default":24},"limit":{"type":"integer","minimum":1,"maximum":50,"default":20}}}}}},"responses":{"200":{"description":"Successful response."},"402":{"description":"Payment required: 0.002 USDC."}},"x-x402":{"payment_required":true,"price_usdc":"0.002","network":"eip155:8453"}}},"/quellen":{"post":{"operationId":"news_sources","summary":"List the managed feeds with topic, language, outlet and last harvest state. Free, no payment required.","description":"Shows which feeds back a topic and language before an agent decides to buy an event list. Free on purpose: an agent has to see the source base to judge what a source count is worth.","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{}}}}},"responses":{"200":{"description":"Successful response."}},"x-x402":{"payment_required":false,"price_usdc":"0","network":"eip155:8453"}}}}}