feat: add example test runner and fix crawler tests (#40)

* refactor: remove anp/node module and related examples

Remove the ANPNode unified server/client module that was experimental:
- Delete anp/node/ directory (node.py, __init__.py, DESIGN.md, DESIGN.cn.md)
- Delete examples/python/minimal_example/minimal_anp_node.py
- Delete examples/python/minimal_example/minimal_two_nodes.py

The functionality can be achieved by using FastANP and ANPClient separately.

Co-Authored-By: Claude Opus 4.5 <[email protected]>

* feat: add example test runner script and fix crawler tests

- Add scripts/run_all_examples.py to run all example scripts
  - Supports standalone examples, server/client pairs, and configurable examples
  - Automatically starts servers before running clients
  - Reports detailed results and configuration requirements
- Fix ANP crawler tests to use correct module paths (anp.* instead of octopus.*)
- Fix simple_amap_example.py URL path
- Update CLAUDE.md with run_all_tests.py commands
- Update README.cn.md with crawler usage clarifications

Co-Authored-By: Claude Opus 4.5 <[email protected]>

* update blogs

---------

Co-authored-by: Claude Opus 4.5 <[email protected]>

Author: chgaowei

CLAUDE.md

@@ -20,6 +20,9 @@ uv run pytest --cov=anp                    # Run tests with coverage
 uv run pytest anp/unittest/                # Run core unit tests only
 uv run pytest anp/anp_crawler/test/        # Run ANP crawler tests only
 uv run pytest anp/fastanp/                 # Run FastANP tests only
+uv run python run_all_tests.py             # Run all unit tests (unified script)
+uv run python run_all_tests.py -v          # Run all tests with verbose output
+uv run python run_all_tests.py --cov=anp   # Run all tests with coverage
 ```
 
 **Build and Distribution:**

README.cn.md

@@ -121,6 +121,8 @@ result = await crawler.execute_json_rpc(
 )
 ```
 
+你可以将crawler的接口封装为LLM的tools，这样可以作为ANP客户端与ANP server进行交互。
+
 **特性：**
 - **爬虫风格**：像网络爬虫一样爬取和解析ANP文档
 - **OpenAI Tools格式**：转换接口用于LLM集成
@@ -138,7 +140,7 @@ result = await crawler.execute_json_rpc(
 | **风格** | 代理对象（像本地方法） | 爬虫（爬取文档） |
 | **用法** | `agent.search(query="Tokyo")` | `crawler.execute_tool_call("search", {...})` |
 | **类型安全** | 完整类型提示，异常驱动 | 基于字典的返回 |
-| **适用场景** | 代码中的智能体间调用 | LLM工具集成，数据收集 |
+| **适用场景** | 使用代码访问固定的智能体，构建ANP的Skills | 使用LLM驱动的方式，访问远程的ANP智能体，并且与智能体进行交互 |
 
 ```python
 # RemoteAgent：方法调用像本地方法一样

anp/anp_crawler/test/test_anp_crawler.py

@@ -21,10 +21,10 @@
 # Add parent directory to path for imports
 sys.path.append(str(Path(__file__).parent.parent.parent.parent))
 
-from octopus.anp_sdk.anp_crawler.anp_crawler import ANPCrawler
-from octopus.anp_sdk.anp_crawler.anp_client import ANPClient
-from octopus.anp_sdk.anp_crawler.anp_parser import ANPDocumentParser
-from octopus.anp_sdk.anp_crawler.anp_interface import ANPInterface
+from anp.anp_crawler.anp_crawler import ANPCrawler
+from anp.anp_crawler.anp_client import ANPClient
+from anp.anp_crawler.anp_parser import ANPDocumentParser
+from anp.anp_crawler.anp_interface import ANPInterface, ANPInterfaceConverter
 
 
 class TestANPCrawler(unittest.IsolatedAsyncioTestCase):
@@ -59,7 +59,7 @@ def setUp(self):
         self.test_video_url = "https://grand-hotel.com/media/hotel-tour-video.mp4"
         self.test_audio_url = "https://grand-hotel.com/media/hotel-audio.mp3"
 
-    @patch('octopus.anp_sdk.anp_crawler.anp_client.DIDWbaAuthHeader')
+    @patch('anp.anp_crawler.anp_client.DIDWbaAuthHeader')
     def test_anp_crawler_initialization(self, mock_auth_header):
         """Test ANPCrawler initialization."""
         mock_auth_header.return_value = MagicMock()
@@ -78,7 +78,7 @@ def test_anp_crawler_initialization(self, mock_auth_header):
         self.assertEqual(len(crawler._visited_urls), 0)
         self.assertEqual(len(crawler._cache), 0)
 
-    @patch('octopus.anp_sdk.anp_crawler.anp_client.DIDWbaAuthHeader')
+    @patch('anp.anp_crawler.anp_client.DIDWbaAuthHeader')
     async def test_fetch_text_agent_description(self, mock_auth_header):
         """Test fetching Agent Description document."""
         mock_auth_header.return_value = MagicMock()
@@ -115,7 +115,7 @@ async def test_fetch_text_agent_description(self, mock_auth_header):
         # Agent Description should extract interface URLs but not actual tools yet
         # (would need to fetch the interface files)
 
-    @patch('octopus.anp_sdk.anp_crawler.anp_client.DIDWbaAuthHeader')
+    @patch('anp.anp_crawler.anp_client.DIDWbaAuthHeader')
     async def test_fetch_text_openrpc_document(self, mock_auth_header):
         """Test fetching and parsing OpenRPC document."""
         mock_auth_header.return_value = MagicMock()
@@ -156,7 +156,7 @@ async def test_fetch_text_openrpc_document(self, mock_auth_header):
             self.assertIn("description", interface["function"])
             self.assertIn("parameters", interface["function"])
 
-    @patch('octopus.anp_sdk.anp_crawler.anp_client.DIDWbaAuthHeader')
+    @patch('anp.anp_crawler.anp_client.DIDWbaAuthHeader')
     async def test_fetch_text_with_ref_resolution(self, mock_auth_header):
         """Test OpenRPC $ref resolution in schemas."""
         mock_auth_header.return_value = MagicMock()
@@ -207,7 +207,7 @@ async def test_fetch_text_with_ref_resolution(self, mock_auth_header):
         # At least one $ref should have been resolved
         self.assertTrue(found_ref_resolution, "$ref references should be resolved")
 
-    @patch('octopus.anp_sdk.anp_crawler.anp_client.DIDWbaAuthHeader')
+    @patch('anp.anp_crawler.anp_client.DIDWbaAuthHeader')
     async def test_fetch_text_embedded_openrpc(self, mock_auth_header):
         """Test fetching Agent Description with embedded OpenRPC content."""
         mock_auth_header.return_value = MagicMock()
@@ -269,7 +269,7 @@ async def test_fetch_text_embedded_openrpc(self, mock_auth_header):
                 self.assertIn("firstName", guest_info["properties"])
                 self.assertIn("email", guest_info["properties"])
 
-    @patch('octopus.anp_sdk.anp_crawler.anp_client.DIDWbaAuthHeader')
+    @patch('anp.anp_crawler.anp_client.DIDWbaAuthHeader')
     async def test_fetch_text_error_handling(self, mock_auth_header):
         """Test error handling in fetch_text."""
         mock_auth_header.return_value = MagicMock()
@@ -297,7 +297,7 @@ async def test_fetch_text_error_handling(self, mock_auth_header):
         self.assertIn("Error:", content_json["content"])
         self.assertEqual(len(interfaces_list), 0)
 
-    @patch('octopus.anp_sdk.anp_crawler.anp_client.DIDWbaAuthHeader')
+    @patch('anp.anp_crawler.anp_client.DIDWbaAuthHeader')
     async def test_fetch_image(self, mock_auth_header):
         """Test fetch_image method (pass implementation)."""
         mock_auth_header.return_value = MagicMock()
@@ -314,7 +314,7 @@ async def test_fetch_image(self, mock_auth_header):
         # Should return None for pass implementation
         self.assertIsNone(result)
 
-    @patch('octopus.anp_sdk.anp_crawler.anp_client.DIDWbaAuthHeader')
+    @patch('anp.anp_crawler.anp_client.DIDWbaAuthHeader')
     async def test_fetch_video(self, mock_auth_header):
         """Test fetch_video method (pass implementation)."""
         mock_auth_header.return_value = MagicMock()
@@ -331,7 +331,7 @@ async def test_fetch_video(self, mock_auth_header):
         # Should return None for pass implementation
         self.assertIsNone(result)
 
-    @patch('octopus.anp_sdk.anp_crawler.anp_client.DIDWbaAuthHeader')
+    @patch('anp.anp_crawler.anp_client.DIDWbaAuthHeader')
     async def test_fetch_audio(self, mock_auth_header):
         """Test fetch_audio method (pass implementation)."""
         mock_auth_header.return_value = MagicMock()
@@ -348,7 +348,7 @@ async def test_fetch_audio(self, mock_auth_header):
         # Should return None for pass implementation
         self.assertIsNone(result)
 
-    @patch('octopus.anp_sdk.anp_crawler.anp_client.DIDWbaAuthHeader')
+    @patch('anp.anp_crawler.anp_client.DIDWbaAuthHeader')
     async def test_fetch_auto(self, mock_auth_header):
         """Test fetch_auto method (pass implementation)."""
         mock_auth_header.return_value = MagicMock()
@@ -365,7 +365,7 @@ async def test_fetch_auto(self, mock_auth_header):
         # Should return None for pass implementation
         self.assertIsNone(result)
 
-    @patch('octopus.anp_sdk.anp_crawler.anp_client.DIDWbaAuthHeader')
+    @patch('anp.anp_crawler.anp_client.DIDWbaAuthHeader')
     async def test_caching_functionality(self, mock_auth_header):
         """Test URL caching functionality."""
         mock_auth_header.return_value = MagicMock()
@@ -402,7 +402,7 @@ async def test_caching_functionality(self, mock_auth_header):
         self.assertEqual(crawler.get_cache_size(), 0)
         self.assertEqual(len(crawler.get_visited_urls()), 0)
 
-    @patch('octopus.anp_sdk.anp_crawler.anp_client.DIDWbaAuthHeader')
+    @patch('anp.anp_crawler.anp_client.DIDWbaAuthHeader')
     def test_session_management(self, mock_auth_header):
         """Test session management functionality."""
         mock_auth_header.return_value = MagicMock()
@@ -428,7 +428,7 @@ def test_session_management(self, mock_auth_header):
     def test_url_parameter_removal(self):
         """Test URL parameter removal functionality."""
         # Test with mock since we need to access private method
-        with patch('octopus.anp_sdk.anp_crawler.anp_client.DIDWbaAuthHeader'):
+        with patch('anp.anp_crawler.anp_client.DIDWbaAuthHeader'):
             crawler = ANPCrawler(
                 did_document_path=self.mock_did_document_path,
                 private_key_path=self.mock_private_key_path
@@ -529,12 +529,12 @@ def test_parse_invalid_json(self):
         self.assertEqual(len(result["interfaces"]), 0)
 
 
-class TestANPInterface(unittest.TestCase):
-    """Test cases for ANPInterface class."""
-    
+class TestANPInterfaceConverter(unittest.TestCase):
+    """Test cases for ANPInterfaceConverter class."""
+
     def setUp(self):
         """Set up test environment."""
-        self.converter = ANPInterface()
+        self.converter = ANPInterfaceConverter()
 
     def test_convert_openrpc_method(self):
         """Test converting OpenRPC method to OpenAI Tools format."""
@@ -674,7 +674,7 @@ def test_unsupported_interface_type(self):
     # Add test cases
     suite.addTests(loader.loadTestsFromTestCase(TestANPCrawler))
     suite.addTests(loader.loadTestsFromTestCase(TestANPDocumentParser))
-    suite.addTests(loader.loadTestsFromTestCase(TestANPInterface))
+    suite.addTests(loader.loadTestsFromTestCase(TestANPInterfaceConverter))
 
     # Run tests
     runner = unittest.TextTestRunner(verbosity=2)